{"openapi":"3.1.0","info":{"title":"ScrapeMole Companies: SEC EDGAR company search, profiles, financials and filings for AI agents","version":"1.0.0","description":"Pay-per-call US company data for agents from SEC EDGAR (public domain): company/ticker search, company profiles (industry, incorporation, filer category, addresses, latest filings), XBRL financials (revenue, net income, EPS, cash flow, balance sheet; 5 years + 4 quarters) and filing lists with document links. USDC via x402, no accounts; failed calls are never charged.\n\nPayments: x402 v2, scheme \"exact\", USDC on Base (eip155:8453). The payment is verified before the work and settled only when the response is 200. Terms: https://companies.scrapemole.workers.dev/terms","contact":{"email":"edgaras@mail.grokbot.com","url":"https://scrapemole.pages.dev"},"x-guidance":"Call any /v1 endpoint without payment to receive a 402 with the exact price, then retry with an x402 client (e.g. @x402/fetch). 4xx/5xx responses are never charged."},"servers":[{"url":"https://companies.scrapemole.workers.dev"}],"components":{"securitySchemes":{"x402":{"type":"http","scheme":"x402","description":"HTTP 402 payment with USDC via the x402 protocol."}}},"paths":{"/v1/search":{"get":{"operationId":"search","summary":"Find US-listed companies by name or ticker: ticker, SEC CIK, legal name and exchange (about 10,000 SEC filers).","description":"Use when you have a company name (or partial ticker) and need its exact ticker and SEC CIK before looking up financials or filings: matches against SEC's official ticker list (NYSE, Nasdaq, OTC, CBOE; about 10,000 SEC-registered companies), exact ticker first, then ticker prefix and name words. Up to 25 results.","tags":["companies","sec","edgar","tickers","stocks","search"],"parameters":[{"name":"q","in":"query","required":true,"description":"Company name or ticker, e.g. \"nvidia\" or \"MSF\".","schema":{"type":"string","examples":["nvidia"]}},{"name":"limit","in":"query","required":false,"description":"Max results (1-25).","schema":{"type":"string","default":"10"}}],"security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001","currency":"USD","network":"eip155:8453","networks":["eip155:8453"],"asset":"USDC"},"responses":{"200":{"description":"Result (the payment settles only for this status).","content":{"application/json":{"example":{"query":"nvidia","count":1,"results":[{"ticker":"NVDA","cik":1045810,"name":"NVIDIA CORP","exchange":"Nasdaq","match":"name"}],"listDate":"2026-10-11"}}}},"400":{"description":"Invalid input. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"402":{"description":"Payment required (x402). The PAYMENT-REQUIRED header (mirrored in the body) carries price, network and payTo."},"404":{"description":"Not found / no data. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"502":{"description":"Upstream error. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"504":{"description":"Upstream timeout. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}}}}},"/v1/company":{"get":{"operationId":"company","summary":"Company profile from SEC EDGAR by ticker or CIK: legal name, tickers, exchanges, SIC industry, state of incorporation, fiscal year end, filer category, addresses, former names, latest filings.","description":"Use when you need the official facts about a US-listed or SEC-registered company: resolves a ticker or CIK and returns the EDGAR profile (legal name, all tickers and exchanges, SIC code and industry, entity type, filer category such as Large Accelerated Filer, state/country of incorporation, fiscal year end, business and mailing address, company phone, website if filed, former names) plus its 10 most recent company filings with links. Insider and beneficial-owner forms (3/4/5/144/13D/13G) are excluded.","tags":["companies","sec","edgar","company-data","kyb","stocks"],"parameters":[{"name":"ticker","in":"query","required":false,"description":"Stock ticker, e.g. AAPL. Give ticker or cik.","schema":{"type":"string","examples":["AAPL"]}},{"name":"cik","in":"query","required":false,"description":"SEC Central Index Key, e.g. 320193. Give ticker or cik.","schema":{"type":"string"}}],"security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.002","currency":"USD","network":"eip155:8453","networks":["eip155:8453"],"asset":"USDC"},"responses":{"200":{"description":"Result (the payment settles only for this status).","content":{"application/json":{"example":{"cik":320193,"name":"Apple Inc.","tickers":["AAPL"],"exchanges":["Nasdaq"],"sic":"3571","industry":"Electronic Computers","entityType":"operating","filerCategory":"Large Accelerated Filer","stateOfIncorporation":"CA","fiscalYearEnd":"0926","businessAddress":{"street1":"ONE APPLE PARK WAY","city":"CUPERTINO","state":"CA","zip":"95014"},"phone":"(408) 996-1010","formerNames":[{"name":"APPLE COMPUTER INC","from":"1994-01-26","to":"2007-01-04"}],"latestFilings":[{"form":"10-Q","filingDate":"2026-07-31","reportDate":"2026-06-27","accessionNumber":"0000320193-26-000020","documentUrl":"https://www.sec.gov/Archives/edgar/data/320193/000032019326000020/aapl-20260627.htm"}],"edgarUrl":"https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=320193"}}}},"400":{"description":"Invalid input. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"402":{"description":"Payment required (x402). The PAYMENT-REQUIRED header (mirrored in the body) carries price, network and payTo."},"404":{"description":"Not found / no data. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"502":{"description":"Upstream error. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"504":{"description":"Upstream timeout. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}}}}},"/v1/financials":{"get":{"operationId":"financials","summary":"Key financials as reported to the SEC (XBRL): revenue, gross profit, operating income, net income, diluted EPS, operating cash flow, capex, R&D, assets, liabilities, equity, cash, long-term debt; last 5 fiscal years and 4 quarters.","description":"Use when you need a public company's reported numbers without scraping filings: pulls the company's XBRL facts from SEC EDGAR and returns 13 standard metrics (US GAAP), each with the source concept, unit, the last 5 fiscal-year values and last 4 quarterly (3-month or point-in-time) values, with period dates, form, filing date and accession number for audit. Plus latest shares outstanding. Values are as filed (not adjusted).","tags":["financials","sec","xbrl","edgar","fundamentals","stocks","company-data"],"parameters":[{"name":"ticker","in":"query","required":false,"description":"Stock ticker, e.g. AAPL. Give ticker or cik.","schema":{"type":"string","examples":["AAPL"]}},{"name":"cik","in":"query","required":false,"description":"SEC CIK. Give ticker or cik.","schema":{"type":"string"}},{"name":"metrics","in":"query","required":false,"description":"Comma-separated subset, e.g. \"revenue,netIncome\". Default all.","schema":{"type":"string"}}],"security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.004","currency":"USD","network":"eip155:8453","networks":["eip155:8453"],"asset":"USDC"},"responses":{"200":{"description":"Result (the payment settles only for this status).","content":{"application/json":{"example":{"cik":320193,"name":"Apple Inc.","ticker":"AAPL","currency":"USD","metrics":{"revenue":{"concept":"us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax","unit":"USD","annual":[{"start":"2024-09-29","end":"2025-09-27","value":416161000000,"fy":2025,"fp":"FY","form":"10-K","filed":"2025-10-31","accn":"0000320193-25-000079"}],"quarterly":[{"start":"2026-03-29","end":"2026-06-27","value":109417000000,"fy":2026,"fp":"Q3","form":"10-Q","filed":"2026-07-31","accn":"0000320193-26-000020"}]}},"sharesOutstanding":{"value":14594180000,"asOf":"2026-07-17","form":"10-Q"}}}}},"400":{"description":"Invalid input. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"402":{"description":"Payment required (x402). The PAYMENT-REQUIRED header (mirrored in the body) carries price, network and payTo."},"404":{"description":"Not found / no data. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"502":{"description":"Upstream error. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"504":{"description":"Upstream timeout. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}}}}},"/v1/filings":{"get":{"operationId":"filings","summary":"Recent SEC filings of a company (10-K, 10-Q, 8-K with item codes, 20-F, S-1, proxy…) with filing and report dates and direct links to the document and index.","description":"Use when you need to find a company's annual report, latest quarterly report, recent 8-K events or registration statements: lists the company's recent EDGAR filings (newest first, up to the last ~1000), filtered by form type and date, each with filing date, period of report, accession number, 8-K item codes, size and direct URLs to the primary document and filing index. Insider and beneficial-owner forms (3/4/5/144/13D/13G) are excluded.","tags":["sec","filings","edgar","10-k","8-k","companies"],"parameters":[{"name":"ticker","in":"query","required":false,"description":"Stock ticker. Give ticker or cik.","schema":{"type":"string","examples":["AAPL"]}},{"name":"cik","in":"query","required":false,"description":"SEC CIK. Give ticker or cik.","schema":{"type":"string"}},{"name":"forms","in":"query","required":false,"description":"Comma-separated form types (amendments included), e.g. \"10-K,8-K\". Default: 10-K,10-Q,8-K,20-F,6-K,40-F,S-1,DEF 14A,424B4. Use \"all\" for every company form.","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Only filings on or after this date (YYYY-MM-DD).","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max filings (1-100).","schema":{"type":"string","default":"20"}}],"security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.002","currency":"USD","network":"eip155:8453","networks":["eip155:8453"],"asset":"USDC"},"responses":{"200":{"description":"Result (the payment settles only for this status).","content":{"application/json":{"example":{"cik":320193,"name":"Apple Inc.","count":1,"filings":[{"form":"8-K","filingDate":"2026-07-31","reportDate":"2026-07-31","accessionNumber":"0000320193-26-000018","items":"2.02,9.01","documentUrl":"https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/aapl-20260731.htm","indexUrl":"https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/0000320193-26-000018-index.htm"}]}}}},"400":{"description":"Invalid input. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"402":{"description":"Payment required (x402). The PAYMENT-REQUIRED header (mirrored in the body) carries price, network and payTo."},"404":{"description":"Not found / no data. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"502":{"description":"Upstream error. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"504":{"description":"Upstream timeout. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}}}}}}}