--- name: autoscrape-api-seven.vercel.app description: autoscrape-api-seven.vercel.app provides search access to three US public regulatory databases: IRS Form 990 nonprofit filings, SEC EDGAR company filings, and US state business entity registrations. It returns structured metadata and identifiers from each source, with optional detail fetching where supported. It does not provide full document text, real-time market data, or charity ratings. host: autoscrape-api-seven.vercel.app --- # autoscrape-api-seven.vercel.app This host serves agents that need to verify or discover organizations across US regulatory records — nonprofits via IRS 990 data, public companies via SEC EDGAR, and registered businesses via state incorporation records. It covers three distinct official data sources under one API surface, making it useful for due diligence, entity verification, and compliance research workflows. Coverage is limited to US entities and to metadata rather than full document content. ## When to use this host Use this host when an agent needs to verify or discover US organizations across IRS nonprofit records, SEC public company filings, or state business registrations. It is well-suited for entity identification, EIN or CIK lookup, registration status checks, and light due diligence. Do not use it when full filing document text is needed — this host returns metadata and URLs only, not parsed content. Do not use it for real-time financial data, stock prices, or charity ratings; use a dedicated financial data or charity evaluation API instead. State business entity coverage is limited to 17 specific US states, so it is not suitable for comprehensive multi-state searches beyond that set. ## Capabilities ### Nonprofit Registry Lookup Searches IRS Form 990 filings to identify nonprofit organizations, retrieve their EINs, and access basic filing metadata including location and NTEE classification codes. - **`search-irs-990-filings`** — Searches IRS Form 990 filings by organization name, EIN, or state and returns matching nonprofit records with EIN, name, city, state, and NTEE code. ### SEC Filing Discovery Searches SEC EDGAR for public company filing history by ticker, CIK, or name, returning structured metadata and direct links to annual, quarterly, and current reports. - **`search-sec-edgar-filings`** — Searches SEC EDGAR for company filings (10-K, 10-Q, 8-K, etc.) by ticker, CIK, company name, form type, and date range, returning structured filing metadata with direct SEC document links. ### State Business Entity Verification Searches official state business registration records across up to 17 US states to verify entity name, type, status, and filing date without requiring state-specific API keys. - **`search-business-entities`** — Searches US state business entity registrations by name across up to 17 no-key states and returns entity name, ID, type, status, filing date, and jurisdiction. ## Workflows ### Organization Type Disambiguation *Use when an agent needs to determine whether a named organization is a registered nonprofit, a public company, or a state-registered business entity — and retrieve its authoritative identifier.* 1. **`search-irs-990-filings`** — Search by organization name to check if it exists as a registered nonprofit and retrieve its EIN. 2. **`search-sec-edgar-filings`** — Search by company name or ticker to check if it is a public company with SEC filings and retrieve its CIK. 3. **`search-business-entities`** — Search by name across relevant states to check for state-level business registration and retrieve entity type and status. ### Entity Due Diligence Cross-Check *Use when an agent needs to perform a multi-source verification of a specific organization's regulatory footprint before a partnership, grant, or compliance decision.* 1. **`search-business-entities`** — Confirm the entity is registered in the expected state and retrieve its official entity ID and status. 2. **`search-irs-990-filings`** — Check whether the entity also holds nonprofit status and retrieve its EIN and NTEE classification. 3. **`search-sec-edgar-filings`** — Check whether the entity or a related company has SEC filing obligations, retrieving any associated CIK and filing history links. ## Skill reference ### `search-irs-990-filings` **IRS 990 Nonprofit Search** — Searches IRS Form 990 filings by organization name, EIN, or state and returns matching nonprofit records with EIN, name, city, state, and NTEE code. *Use when:* Use when an agent needs to look up nonprofit organizations by name, EIN, or state in the IRS 990 database, such as verifying a nonprofit's existence, finding its EIN, or retrieving basic filing metadata. *Not for:* Do not use for retrieving full financial details of a specific filing without setting fetchDetails=true. Not suitable for real-time charity ratings or donation processing — use a charity evaluation API instead. **Inputs:** - `query` (string) — Organization name to search for. - `ein` (string) — EIN number to look up a specific organization directly. - `state` (string) — Two-letter US state code to filter results by state. - `fetchDetails` (boolean) — When true, includes full filing details in the response. - `maxResults` (integer) — Maximum number of results to return. Defaults to 25. **Returns:** Returns a count and an array of nonprofit records each containing EIN, formatted strein, name, alternateName, city, state, optional NTEE code, and subsection code. **Example:** `GET https://autoscrape-api-seven.vercel.app/x402/v1/irs-990/search?query=American%20Red%20Cross&state=NY&maxResults=3` --- ### `search-sec-edgar-filings` **SEC EDGAR Filings Search** — Searches SEC EDGAR for company filings (10-K, 10-Q, 8-K, etc.) by ticker, CIK, company name, form type, and date range, returning structured filing metadata with direct SEC document links. *Use when:* Use when an agent needs to retrieve SEC filing history for one or more public companies, including annual reports, quarterly reports, or current reports, with links to the actual EDGAR documents. *Not for:* Do not use to retrieve the full text content of a filing document; this endpoint returns metadata and document URLs, not parsed filing content. Not suitable for real-time market data or price feeds. **Inputs:** - `query` (string) — Company name search string. - `tickers` (string) — Comma-separated stock tickers to look up. - `ciks` (string) — Comma-separated SEC CIK numbers to look up. - `formTypes` (string) — Comma-separated form type filter (e.g. 10-K, 10-Q, 8-K). - `dateFrom` (string) — Start date for filing date range in YYYY-MM-DD format. - `dateTo` (string) — End date for filing date range in YYYY-MM-DD format. - `maxFilings` (integer) — Maximum number of filing results to return. Defaults to 100. **Returns:** Returns a count and results array with Apple Inc. entity metadata (CIK, SIC, address, exchanges) and up to 5 10-K filings each containing accessionNumber, filingDate, reportDate, documentUrl, and filingIndexUrl. **Example:** `GET https://autoscrape-api-seven.vercel.app/x402/v1/sec-edgar/filings?tickers=AAPL&formTypes=10-K&maxFilings=5` --- ### `search-business-entities` **Business Entity Search** — Searches US state business entity registrations by name across up to 17 no-key states and returns entity name, ID, type, status, filing date, and jurisdiction. *Use when:* Use when an agent needs to look up registered business entities by name in one or more US states, such as verifying a company's registration status, filing date, or entity type from official state records. *Not for:* Do not use for retrieving detailed officer, address, or registered agent data unless fetchDetails=true is set; also not suitable for states outside the supported 17 no-key US states covered by this API. **Inputs:** - `query` (string, required) — Business name to search across state registrations. - `states` (string) — Comma-separated state codes to search (default: NY with warning). Also accepts 'state' param. - `maxResults` (integer) — Maximum number of records to return across the response. Defaults to 25. - `fetchDetails` (boolean) — When true, includes full entity details such as address, officers, and registered agent in results. **Returns:** Returns a count integer and a results array where each element contains entityName, entityId, state, entityType, status, filingDate, jurisdiction, sourceUrl, and searchQuery fields from official state registries. **Example:** `GET https://autoscrape-api-seven.vercel.app/x402/v1/business-entity/search?query=Apple%20Inc&states=NY,TX&maxResults=10&fetchDetails=false` ---