pvsR (version 0.1.1)

Votes.getBillActionVotes: Get votes listed by candidate on a certain bill action

Description

This function is a wrapper for the Votes.getBillActionVotes() method of the PVS API Votes class which provides votes listed by candidate on a certain bill action. The function sends a request with this method to the PVS API for all action IDs given as a function input, extracts the XML values from the returned XML file(s) and returns them arranged in one data frame.

Usage

Votes.getBillActionVotes(actionId)

Arguments

actionId

a character string or list of character strings with the action ID(s) (see references for details)

Value

• A data frame with a row for each vote and columns with variables describing the vote. The returned data frame contains a row for each vote and columns with the following variables describing the vote: votes.vote*.candidateId, votes.vote*.candidateName, votes.vote*.officeParties, votes.vote*.action.

References

http://api.votesmart.org/docs/Votes.html Use Votes.getBill() or Votes.getByOfficial() to get a list of action IDs.

Examples

# First, make sure your personal PVS API key is saved as character string in the pvs.key variable:
pvs.key <- "yourkey"
# get votes of a certain candidate on a certain action
actionvote <- Votes.getBillActionVotes(list(31712,28686))
actiovote