SEC Form N-PX Proxy Voting Records Scraper API

Search institutional proxy-voting disclosures filed on official SEC EDGAR Form N-PX and extract source-linked vote evidence from selected filing documents. Use it for stewardship research, fund-vote comparison, governance screening, and filing monitoring.

Deterministic first run

{
  "query": "BlackRock",
  "startDate": "2025-01-01",
  "includeAmendments": false,
  "maxFilings": 1,
  "scanLimit": 25,
  "maxResults": 3
}

Candidates are sorted by filing date and accession—not EFTS relevance—before the newest filing is fetched. The default emits at most three parsed vote rows. If that selected filing is a fund notice or its format cannot be safely parsed, one explicit PARSE_UNAVAILABLE filing-evidence row is returned instead of invented votes.

Inputs

Search by fund/manager query, exact cik or accession, filing dates, amendment inclusion, issuer/security/CUSIP/proposal keyword, proposal category, management recommendation, and vote cast. scanLimit bounds search candidates; maxFilings bounds SEC Archives follow-ups; maxResults is a total output cap. Exact accessions use 0000000000-00-000000 format.

Example governance screen:

{
  "query": "BlackRock",
  "startDate": "2025-01-01",
  "issuerQuery": "Apple",
  "proposalQuery": "director",
  "voteCast": "against",
  "maxFilings": 5,
  "scanLimit": 50,
  "maxResults": 20
}

Output and explicit outcomes

Found rows preserve filing date/form/accession/CIK/filer/report period, fund and issuer, security title, CUSIP or other identifier, meeting date, proposal number/text/category, management recommendation, vote instruction, reported shares voted/loaned, official filing/index URLs, retrieval time, and bounded-coverage fields.

Outcomes are FOUND, NO_MATCH, PARSE_UNAVAILABLE, SOURCE_UNAVAILABLE, and INVALID_INPUT. No match means only that no parsed row met all filters in the disclosed bounded window.

Price and bounds

Pricing is $0.0001 per start + $0.002 per dataset item. The three-item default costs at most $0.0061. Apify maximum-charge budgets reduce the total result limit before filing-document work. Increasing limits increases potential charge and SEC requests.

Evidence limits

Form N-PX is filer-submitted periodic disclosure. Filings may be amended and can use issuer-, filer-, series-, or fund-specific XML/HTML formatting. A filing may be a notice report with no vote table. Blank values mean unknown/not reported, not zero or “none.”

Results do not establish SEC verification, beneficial ownership, current holdings, investment advice, a governance outcome, or a complete/live voting record. Confirm material conclusions against the linked filing, amendments, and other current sources.

SEC fair access

The actor uses the official no-key EDGAR full-text JSON endpoint and official SEC Archives only, sends an identifying User-Agent, applies conservative sequential pacing, timeouts, response-size limits, and bounded retries for transient failures and HTTP 408/429/5xx responses. Keep limits modest and follow the SEC privacy and security policy.