Provided by SEC API
Get One Section of a 10-K, 10-Q or 8-K Filing as Text by URL (SEC API)
Get the plain text of one item section from a single 10-K, 10-Q or 8-K filing whose sec.gov document URL you already have. Supply url (the www.sec.gov/Archives/edgar/data path of the main document) and item: 10-K items like 1A (risk factors) or 7 (management's discussion and analysis), 10-Q items like part2item1a, 8-K items like 2-2. The item must belong to the form of that URL. Returns only that section's text, no HTML and no other sections; it does not search across filings.
How to run it
Step 1Set up
Once: paste this into your agent's chat. The Skill installs the CLI and logs in by itself. For an agent that cannot use a shell, connect it over MCP instead.
set up https://glasser.ai/SKILL.md
Show me how to use the SEC API endpoint /extractor on Glasser.glasser run -p secapi -e '/extractor' -i '{"url":"https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm","item":"1A"}' --endpoint-version 1Uses endpoint version 1. Inspect the current price before running. Install and log in first on Get Started.
Once per Run:
IDEMPOTENCY_KEY=$(uuidgen)Run it, and copy this same block to send it again:
curl -X POST https://api.glasser.ai/v1/runs \
-H "Authorization: Bearer gl_..." \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{"provider":"secapi","endpoint":"/extractor","input":{"url":"https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm","item":"1A"},"endpoint_version":1}'Reuse the same Idempotency-Key to send it again: the second send is a read of the first Run. A new key is a new Run and a new Charge. Uses endpoint version 1; inspect the current price before running.
Step 2Try a specific example task
When you need to research a company disclosure, you might look through filing data for passages relevant to the question you are investigating.
Copy this prompt into your agent to find disclosures relevant to your research topic.
Use secapi:/extractor on Glasser.
Find disclosures about my research topic in the returned filing data.Endpoint structure
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url",
"item"
],
"properties": {
"url": {
"type": "string",
"pattern": "^https:\\/\\/www\\.sec\\.gov\\/Archives\\/edgar\\/data\\/\\d{1,10}\\/\\d{18}\\/[A-Za-z0-9][A-Za-z0-9._-]*$",
"maxLength": 300
},
"item": {
"enum": [
"1",
"1A",
"1B",
"1C",
"2",
"3",
"4",
"5",
"6",
"7",
"7A",
"8",
"9",
"9A",
"9B",
"9C",
"10",
"11",
"12",
"13",
"14",
"15",
"part1item1",
"part1item2",
"part1item3",
"part1item4",
"part2item1",
"part2item1a",
"part2item2",
"part2item3",
"part2item4",
"part2item5",
"part2item6",
"1-1",
"1-2",
"1-3",
"1-4",
"1-5",
"2-1",
"2-2",
"2-3",
"2-4",
"2-5",
"2-6",
"3-1",
"3-2",
"3-3",
"4-1",
"4-2",
"5-1",
"5-2",
"5-3",
"5-4",
"5-5",
"5-6",
"5-7",
"5-8",
"6-1",
"6-2",
"6-3",
"6-4",
"6-5",
"6-6",
"6-10",
"7-1",
"8-1",
"9-1",
"signature"
],
"type": "string"
}
},
"additionalProperties": false
}{
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm",
"item": "1A"
}This Endpoint publishes no output schema. You get the Provider's own response body, unchanged — we do not warrant a shape we cannot guarantee.
How pricing works
| Data returned | Charged only when data is returned. | $0.0005 |
|---|---|---|
| Provider error | The Provider failed to answer. | $0.00 |
| Timed out | The Run exceeded its time limit. | $0.00 |
| Internal failure | An internal error prevented completion. | $0.00 |