API Reference

Extractor API

GET/extractor

The Extractor endpoint allows you to extract structured text blocks from SEC 10-K filings in HTML format. The response object will contain a list of JSON blocks.

BASE URL
https://api.textblocks.app

QUERY PARAMETERS

urlstring

The url of the HTML 10-K filing to be extracted. The url must be from the SEC Edgar website.

itemstring

The item from the 10-K filing to be extracted.

Accepted values: 1, 1A, 2, 3, 4, 5, 6, 7, 7A, 8, 9A, 9B, 9C, 10, 11, 12, 13, 14, 15, 16

emailstring

The email associated with your TextBlocks account.

api_keystring

Your TextBlocks API key.

RESPONSE OBJECT

typestring

The type of text extracted in each block.

HEADING: highlighted text that represents a section heading or title

Example: Market Risk Factors

TEXT: standard block of text

LIST_ITEM: single bullet of text within a list

EMPHASIZED_STATEMENT: highlighted text that represents a standalone sentence or statement

Example: We may be adversely affected by supply chain issues and inventory shortages.

textstring

The extracted text from a specific block.

SAMPLE REQUEST

curl --location --request GET 'https://api.textblocks.app/extractor?url=https://www.sec.gov/Archives/edgar/data/1403161/000140316123000099/v-20230930.htm&item=1A&email=YOUR_EMAIL&api_key=YOUR_API_KEY'
RESPONSE

[
    {
        "type": "HEADING",
        "text": "ITEM 1A.  RISK FACTORS"
    },
    {
        "type": "HEADING",
        "text": "RISKS RELATED TO OUR OPERATIONS"
    },
    {
        "type": "EMPHASIZED_STATEMENT",
        "text": "Unfavorable general economic and geopolitical conditions could negatively impact our financial results."
    }
]

Filings API

GET/filings

The Filings endpoint allows you to retrieve 10-K filing information for a given company ticker. The response object will contain a list of JSON objects.

BASE URL
https://api.textblocks.app

QUERY PARAMETERS

tickerstring

The company ticker.

Example: AAPL

emailstring

The email associated with your TextBlocks account.

api_keystring

Your TextBlocks API key.

RESPONSE
[
    {
        "ticker": "RBLX",
        "cik": 1315098,
        "form": "10-K",
        "accessionNumber": 131509823000035,
        "filingDate": "2023-02-28",
        "reportDate": "2022-12-31",
        "isXBRL": 1,
        "isInlineXBRL": 1,
        "primaryDocument": "rblx-20221231.htm",
        "primaryDocumentUrl": "https://www.sec.gov/Archives/edgar/data/0001315098/000131509823000035/rblx-20221231.htm"
    },
    {
        "ticker": "RBLX",
        "cik": 1315098,
        "form": "10-K",
        "accessionNumber": 131509822000058,
        "filingDate": "2022-02-25",
        "reportDate": "2021-12-31",
        "isXBRL": 1,
        "isInlineXBRL": 1,
        "primaryDocument": "rblx-20211231.htm",
        "primaryDocumentUrl": "https://www.sec.gov/Archives/edgar/data/0001315098/000131509822000058/rblx-20211231.htm"
    }
]