String docs
Site integrations

OpenSecrets

OpenSecrets donor lookup: search a name and read the merged federal + state campaign contributions the results table lists — category, contributor, employer, occupation, date, amount, recipient and jurisdiction.

Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.

  • Site: opensecrets
  • Version: 1.0.0
  • Reads from: www.opensecrets.org
ActionDescriptionListed price
donationsLook up a name in OpenSecrets donor search and get each contribution row the merged federal + state results table lists: category, contributor, employer, occupation, date, amount, recipient and jurisdiction. The search matches surnames broadly, so rows name the contributor they actually belong to.Billed per request at your plan's rates

donations

Look up a name in OpenSecrets donor search and get each contribution row the merged federal + state results table lists: category, contributor, employer, occupation, date, amount, recipient and jurisdiction. The search matches surnames broadly, so rows name the contributor they actually belong to.

POST https://request.usestring.ai/v1/integrations/opensecrets/donations

Input

Unknown fields are rejected.

FieldTypeDescription
namestringRequired. The donor's name, such as Marc Benioff; OpenSecrets matches surnames broadly. At least 1 character.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
positionintegerThe row's place in the results table, from 1.
categorystring | nullThe contribution type the row shows, such as Donor.
contributorstringThe donor name the row records.
employerstring | nullThe employer the row records.
occupationstring | nullThe occupation the row records.
datestring | nullThe contribution date as the row shows it.
amountstring | nullThe contribution amount as the row shows it, such as $5,600.
recipientstring | nullThe candidate or committee the row names.
jurisdictionstring | nullThe election's jurisdiction, such as Federal or a state code.
urlstringThe results page the row came from.

Example

curl https://request.usestring.ai/v1/integrations/opensecrets/donations \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "smith"
  }'

data starts with these rows:

[
  {
    "position": 1,
    "category": "Money to Candidates",
    "contributor": "SMITH, SMITH SAN FRANCISCO, CA 94116",
    "employer": "INTUIT, INC",
    "occupation": "SR. DATA SCIENTIST",
    "date": "09-19-2016",
    "amount": "$250",
    "recipient": "Tammy for Illinois",
    "jurisdiction": "Federal",
    "url": "https://www.opensecrets.org/donor-lookup/results?name=smith"
  }
]

Requests and billing

  • Requests: 1–3 Web Access requests per call.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.