Alpha AnalystDocs
API Portal

Document Search API

Search SEC EDGAR, Japan EDINET, and your uploads in one call—or browse whole filings without query. Ranked excerpts on hits; filter by source and form via Document Types.

curl -X GET "https://example.com/v2/documents?query=iPhone&id=AAPL&sources=sec&size=2&chunks_size=2"

{  "size": 2,  "results": [    {      "document_id": "0000320193-25-000079|0",      "filing_id": "0000320193-25-000079",      "source": "sec",      "title": "10-K",      "document_type": "10-K",      "filing_type": "10-K",      "filed_at": "2025-10-31T04:00:00.000Z",      "filename": "aapl-20250927.htm",      "entities": [        {          "name": "Apple Inc.",          "name_short": "Apple Inc.",          "full_ticker": "AAPL US",          "normalized_ticker": "AAPL",          "exchange_code": "UB",          "composite_code": "US",          "backlink_url": "https://alpha-analyst.com/stocks/aapl",          "category": "EQUITY",          "cik": "0000320193",          "edinet_code": "",          "lei": "HWUPKR0MPOU8FGXBT394",          "crd_number": "",          "series_id": "",          "internal_id": "",          "figi": "BBG000B9XXW3",          "composite_figi": "BBG000B9XRY4",          "share_class_figi": "BBG001S5N8V8",          "entity_is_public": 1,          "is_person": 0,          "is_actively_trading": 1,          "sec_type": "Common Stock",          "sec_type2": "Common Stock",          "market_sector": "Equity",          "generic_sic_code": "3571",          "score": 0,          "resolved": true,          "filer_type": "FILER",          "fy": "2025",          "q": "FY"        }      ],      "sequence": 1,      "pages": 60,      "score": 22.016867,      "excerpts": [        {          "text": "The Company designs, manufactures and markets smartphones, personal computers, tablets, wearables and accessories, and sells a variety of related services. The Company’s fiscal year is the 52- or 53-week period that ends on the last Saturday of September.\n\nProducts\n\niPhone\n\niPhone® is the Company’s line of smartphones based on its iOS operating system. The iPhone line includes iPhone 17 Pro, iPhone Air™, iPhone 17, iPhone 16 and iPhone 16e.\n\nMac\n\nMac® is the Company’s line of personal computers based on its macOS® operating system. The Mac line includes laptops MacBook Air® and MacBook Pro®, as well as desktops iMac®, Mac mini®, Mac Studio® and Mac Pro®.\n\niPad\n\niPad® is the Company’s line of multipurpose tablets based on its iPadOS® operating system. The iPad line includes iPad Pro®, iPad Air®, iPad and iPad mini®.\n\nWearables, Home and Accessories\n\nWearables includes smartwatches, wireless headphones and spatial computers. The Company’s line of smartwatches, based on its watchOS® operating system, includes Apple Watch® Series 11, Apple Watch SE® 3 and Apple Watch Ultra® 3. The Company’s line of wireless headphones includes AirPods®, AirPods Pro®, AirPods Max® and Beats® products. Apple Vision Pro™ is the Company’s spatial computer based on its visionOS® operating system.\n\nHome includes Apple TV 4K®, the Company’s media streaming and gaming device based on its tvOS® operating system, and HomePod® and HomePod mini®, high-fidelity wireless smart speakers.\n\nAccessories includes Apple-branded and third-party accessories.\n\nApple Inc. | 2025 Form 10-K | 1\n\n---\n\nServices\n\nAdvertising\n\nThe Company’s advertising services include third-party licensing arrangements and the Company’s own advertising platforms.\n\nAppleCare",          "chunk_index": 5        },        {          "text": "| | | | | | | | | | | |\n| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |\n| | 2025 | | Change | | 2024 | | Change | | 2023 | |\n| Americas | $ | 178,353 | 7 | % | $ | 167,045 | 3 | % | $ | 162,560 |\n| Europe | 111,032 | | 10 | % | 101,328 | | 7 | % | 94,294 | |\n| Greater China | 64,377 | | (4) | % | 66,952 | | (8) | % | 72,559 | |\n| Japan | 28,703 | | 15 | % | 25,052 | | 3 | % | 24,257 | |\n| Rest of Asia Pacific | 33,696 | | 10 | % | 30,658 | | 4 | % | 29,615 | |\n| Total net sales | $ | 416,161 | 6 | % | $ | 391,035 | 2 | % | $ | 383,285 |\n\nAmericas\n\nAmericas net sales increased during 2025 compared to 2024 primarily due to higher net sales of iPhone and Services. The weakness in foreign currencies relative to the U.S. dollar had an unfavorable year-over-year impact on Americas net sales during 2025.\n\nEurope\n\nEurope net sales increased during 2025 compared to 2024 primarily due to higher net sales of Services, iPhone and Mac.\n\nGreater China\n\nGreater China net sales decreased during 2025 compared to 2024 primarily due to lower net sales of iPhone, partially offset by higher net sales of Mac.\n\nJapan\n\nJapan net sales increased during 2025 compared to 2024 primarily due to higher net sales of iPhone, Services and iPad.\n\nRest of Asia Pacific\n\nRest of Asia Pacific net sales increased during 2025 compared to 2024 primarily due to higher net sales of iPhone, Services and Mac.\n\nApple Inc. | 2025 Form 10-K | 22\n\n---\n\nProducts and Services Performance\n\nThe following table shows net sales by category for 2025, 2024 and 2023 (dollars in millions):",          "chunk_index": 67        }      ],      "backlink_url": "https://alpha-analyst.com/app/filing/0000320193/0000320193-25-000079?filename=aapl-20250927.htm",      "source_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",      "source_filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.html"    },    {      "document_id": "0000320193-24-000123|0",      "filing_id": "0000320193-24-000123",      "source": "sec",      "title": "10-K",      "document_type": "10-K",      "filing_type": "10-K",      "filed_at": "2024-11-01T04:00:00.000Z",      "filename": "aapl-20240928.htm",      "entities": [        {          "name": "Apple Inc.",          "name_short": "Apple Inc.",          "full_ticker": "AAPL US",          "normalized_ticker": "AAPL",          "exchange_code": "UB",          "composite_code": "US",          "backlink_url": "https://alpha-analyst.com/stocks/aapl",          "category": "EQUITY",          "cik": "0000320193",          "edinet_code": "",          "lei": "HWUPKR0MPOU8FGXBT394",          "crd_number": "",          "series_id": "",          "internal_id": "",          "figi": "BBG000B9XXW3",          "composite_figi": "BBG000B9XRY4",          "share_class_figi": "BBG001S5N8V8",          "entity_is_public": 1,          "is_person": 0,          "is_actively_trading": 1,          "sec_type": "Common Stock",          "sec_type2": "Common Stock",          "market_sector": "Equity",          "generic_sic_code": "3571",          "score": 0,          "resolved": true,          "filer_type": "FILER",          "fy": "2024",          "q": "FY"        }      ],      "sequence": 1,      "pages": 59,      "score": 21.894382,      "excerpts": [        {          "text": "The Company designs, manufactures and markets smartphones, personal computers, tablets, wearables and accessories, and sells a variety of related services. The Company’s fiscal year is the 52- or 53-week period that ends on the last Saturday of September.\n\nProducts\n\niPhone\n\niPhone® is the Company’s line of smartphones based on its iOS operating system. The iPhone line includes iPhone 16 Pro, iPhone 16, iPhone 15, iPhone 14 and iPhone SE®.\n\nMac\n\nMac® is the Company’s line of personal computers based on its macOS® operating system. The Mac line includes laptops MacBook Air® and MacBook Pro®, as well as desktops iMac®, Mac mini®, Mac Studio® and Mac Pro®.\n\niPad\n\niPad® is the Company’s line of multipurpose tablets based on its iPadOS® operating system. The iPad line includes iPad Pro®, iPad Air®, iPad and iPad mini®.\n\nWearables, Home and Accessories\n\nWearables includes smartwatches, wireless headphones and spatial computers. The Company’s line of smartwatches, based on its watchOS® operating system, includes Apple Watch Ultra® 2, Apple Watch® Series 10 and Apple Watch SE®. The Company’s line of wireless headphones includes AirPods®, AirPods Pro®, AirPods Max® and Beats® products. Apple Vision Pro™ is the Company’s first spatial computer based on its visionOS™ operating system.\n\nHome includes Apple TV®, the Company’s media streaming and gaming device based on its tvOS® operating system, and HomePod® and HomePod mini®, high-fidelity wireless smart speakers.\n\nAccessories includes Apple-branded and third-party accessories.\n\nApple Inc. | 2024 Form 10-K | 1\n\n---\n\nServices\n\nAdvertising\n\nThe Company’s advertising services include third-party licensing arrangements and the Company’s own advertising platforms.\n\nAppleCare",          "chunk_index": 5        },        {          "text": "Japan net sales increased during 2024 compared to 2023 due primarily to higher net sales of iPhone. The weakness in the yen relative to the U.S. dollar had an unfavorable year-over-year impact on Japan net sales during 2024.\n\nRest of Asia Pacific\n\nRest of Asia Pacific net sales increased during 2024 compared to 2023 due primarily to higher net sales of Services. The weakness in foreign currencies relative to the U.S. dollar had a net unfavorable year-over-year impact on Rest of Asia Pacific net sales during 2024.\n\nApple Inc. | 2024 Form 10-K | 22\n\n---\n\nProducts and Services Performance\n\nThe following table shows net sales by category for 2024, 2023 and 2022 (dollars in millions):\n\n| | | | | | | | | | | |\n| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |\n| | 2024 | | Change | | 2023 | | Change | | 2022 | |\n| iPhone | $ | 201,183 | — | % | $ | 200,583 | (2) | % | $ | 205,489 |\n| Mac | 29,984 | | 2 | % | 29,357 | | (27) | % | 40,177 | |\n| iPad | 26,694 | | (6) | % | 28,300 | | (3) | % | 29,292 | |\n| Wearables, Home and Accessories | 37,005 | | (7) | % | 39,845 | | (3) | % | 41,241 | |\n| Services (1) | 96,169 | | 13 | % | 85,200 | | 9 | % | 78,129 | |\n| Total net sales | $ | 391,035 | 2 | % | $ | 383,285 | (3) | % | $ | 394,328 |\n\n(1)Services net sales include amortization of the deferred value of services bundled in the sales price of certain products.\n\niPhone\n\niPhone net sales were relatively flat during 2024 compared to 2023.\n\nMac\n\nMac net sales increased during 2024 compared to 2023 due primarily to higher net sales of laptops.\n\niPad\n\niPad net sales decreased during 2024 compared to 2023 due primarily to lower net sales of iPad Pro and the entry-level iPad models, partially offset by higher net sales of iPad Air.\n\nWearables, Home and Accessories\n\nWearables, Home and Accessories net sales decreased during 2024 compared to 2023 due primarily to lower net sales of Wearables and Accessories.\n\nServices",          "chunk_index": 64        }      ],      "backlink_url": "https://alpha-analyst.com/app/filing/0000320193/0000320193-24-000123?filename=aapl-20240928.htm",      "source_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm",      "source_filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.html"    }  ],  "count": 341,  "next_id": "eyJzZWMiOjJ9.2326426659a511d4"}

GET
/v2/documents

Query Parameters

query?string

Keyword search over document text. Omit to list recent filings. Excerpts are returned only when this is set.

Length1 <= length <= 2000
id?Entity Id

Company or listing id. Same resolve as Entity Reference: ticker (AAPL, AAPL US, AAPL-US), CIK, LEI, EDINET code, CRD, SEC series id, internal id, FIGI, composite FIGI, and share-class FIGI. ISIN and CUSIP match but are never returned. See Ids you can send.

Length1 <= length <= 200
sources?array<string>

sec, edinet, or user. Comma-separated on GET. Omit to search every source you can access. user requires sign-in.

Items1 <= items <= 3
from_date?string

Inclusive start calendar date as YYYY-MM-DD or yyyyMMdd. Filters the source filing or upload day (SEC acceptance, EDINET submission, or upload), which is the same clock filed_at is converted from. See filed_at.

Match^[0-9]{8}$|^[0-9]{4}-[0-9]{2}-[0-9]{2}$
to_date?string

Inclusive end calendar date as YYYY-MM-DD or yyyyMMdd. Filters the source filing or upload day (SEC acceptance, EDINET submission, or upload), which is the same clock filed_at is converted from. See filed_at.

Match^[0-9]{8}$|^[0-9]{4}-[0-9]{2}-[0-9]{2}$
sort_by?string

score or date. Default score. Ignored when query is omitted (browse is always by date).

Default"score"

Value in

  • "score"
  • "date"
sort_order?string

asc or desc. Default desc.

Default"desc"

Value in

  • "asc"
  • "desc"
size?integer

Page size. Default 15. Maximum 30.

Range1 <= value <= 30
Default15
chunks_size?integer

Excerpts per document when query is set. Default 5. Maximum 20.

Range1 <= value <= 20
Default5
filing_type_categories?array<string>

financials_periodic, current_reports, ownership, proxies_agm, registrations_offerings, mna_tenders, correspondence, orders_notices, trust_indenture, or other. current_reports is 8-K and 6-K style disclosures. events is a deprecated alias of current_reports and is not an IR event. Comma-separated on GET. Optional. Maps to native SEC type_category and EDINET disclosure types. Full expansion: Document Types.

Items1 <= items <= 10
filing_types?array<string>

annual_report, periodic_report, current_report, proxy_statement, registration_statement, tender_offer_document, beneficial_ownership_filing, insider_ownership_filing, or a raw SEC form / EDINET code (10-K, 8-K, 120). Comma-separated on GET. Optional. Groups and codes: Document Types.

Items1 <= items <= 40
next_id?string

Cursor from the previous page. Omit on the first page.

Length1 <= length <= 4000

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json