SEC EDGAR API endpoint
Resolves a ticker symbol or company-name query to SEC EDGAR companies (CIK, ticker, name).
/sec/company/searchResolves a ticker symbol or company-name query to SEC EDGAR companies Official SEC data. An exact ticker match is returned first, then name/ticker substring matches ranked by relevance.
Query parameters:
q (required) — ticker symbol or company name.limit (optional, default 10, max 100).Response includes matches[]: cik, cik_padded, ticker, name.
| Field | Filled in, of 6 checked | Values in the sample |
|---|---|---|
| cik | 6 | 63,330 to 1,938,109, median 1,134,982 |
| cik_padded | 6 | “CIK0000320193” and 5 other values |
| ticker | 6 | “AAPL” and 5 other values |
| name | 6 | “Apple Inc.” and 5 other values |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| q | string | Yes | Ticker symbol or company name | apple | |
| limit | integer | No | Max matches, default 10, max 100 | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/sec/company/search?q=apple&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"query": "apple",
"count": 1,
"matches": [
{
"cik": 320193,
"cik_padded": "CIK0000320193",
"ticker": "AAPL",
"name": "Apple Inc."
}
],
"source_url": "https://www.sec.gov/files/company_tickers.json"
}
}Request schema
No body schema
Response schema
#/definitions/sec.companySearchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | sec.CompanySearchResponse | No | ||||
| data.count | integer | No | 1 | Number of companies returned. | ||
| data.matches | array | No | Companies matching the query, exact ticker match first. | |||
| data.matches[].cik | integer | No | 320193 | Company's SEC Central Index Key (CIK) number. | ||
| data.matches[].cik_padded | string | No | CIK0000320193 | CIK number padded to 10 digits with a `CIK` prefix, as used in SEC data URLs. | ||
| data.matches[].name | string | No | Apple Inc. | Company name as registered with the SEC. | ||
| data.matches[].ticker | string | No | AAPL | Stock ticker symbol of the company. | ||
| data.query | string | No | apple | Ticker or company name that was searched. | ||
| data.source_url | string | No | URL the data was read from. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/sec/company/search?q=apple&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"