pvsR (version 0.1.1)

Votes.getVetoes: Get a list of vetoes according to candidate

Description

This function is a wrapper for the Votes.getVetoes() method of the PVS API Votes class which returns a list of vetoes according to candidate. The function sends a request with this method to the PVS API for all candidate 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.getVetoes(candidateId)

Arguments

candidateId

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

Value

• A data frame with a row for each veto and columns with the following variables describing the veto. The returned data frame contains a row for each veto and columns with the following variables describing the veto: bills.bill*.vetoId, bills.bill*.statusDate, bills.bill*.billId, bills.bill*.billNumber, bills.bill*.billTitle, bills.bill*.vetoCode, bills.bill*.vetoType, bills.bill*.billSummary, bills.bill*.billLink, bills.bill*.vetoLetterLink.

References

http://api.votesmart.org/docs/Votes.html Use Candidates.getByOfficeState(), Candidates.getByOfficeTypeState(), Candidates.getByLastname(), Candidates.getByLevenshtein(), Candidates.getByElection(), Candidates.getByDistrict() or Candidates.getByZip() to get a list of candidate IDs.

Examples

# First, make sure your personal PVS API key is saved as character string in the pvs.key variable:
pvs.key <- "yourkey"
# get vetoes by Barack Obama
vetos <- Votes.getVetoes(9490)
vetos