Companies

Search companies

Search for companies by name, ticker, or apply filters.

Search Behavior

The q parameter searches across:

Company names: Partial match, case-insensitive
Ticker symbols: Partial match, case-insensitive

Results are sorted alphabetically by company name.

Search Examples

# Search by ticker
?q=AAPL

# Search by company name
?q=Apple

# Search for tech companies
?q=software

# Search for companies in California
?q=&state=CA

# Find large filers in software industry
?sicCode=7372&category=Large%20Accelerated%20Filer

Filters

All filters can be combined:

Filter	Description	Example
ticker	Exact ticker match	AAPL
sicCode	Industry code	7372 (software)
category	SEC filer category	Large Accelerated Filer
entityType	Entity type	Corporation
state	State of incorporation	CA, DE, NY
hasInsiderTransactions	Has insider filings	true or false

Common SIC Codes

Code	Industry
7372	Prepackaged Software
7370	Computer Programming Services
6022	State Commercial Banks
3674	Semiconductors
2834	Pharmaceutical Preparations
4813	Telephone Communications
5411	Grocery Stores
6798	Real Estate Investment Trusts

Pagination

Results are paginated with cursor-based pagination:

Default limit: 25 items per page
Maximum limit: 100 items per page
Use nextCursor from response to fetch next page

get/api/v1/companies/search

Request

Base URL: https://earningsfeed.com
URL: https://earningsfeed.com/api/v1/companies/search
Auth: HTTP bearer

Query parameters

limitinteger

Number of items to return (1-100)

Example:25

cursorstring

Cursor for pagination (opaque string from previous response)

Example:eyJzb3J0IjoiMjAyNC0xMS0wMVQxMjozMDowMC4wMDBaIiwiaWQiOjEyMzQ1fQ

qstring

Search query matching company name or ticker symbol.

Supports:

Exact ticker match: AAPL
Company name substring: Apple
Partial matches: Micro matches Microsoft, Micron, etc.

Results are ranked by relevance with exact ticker matches first.

Example:Apple

tickerstring

Filter by exact ticker symbol

Example:AAPL

sicCodeinteger nullable

Filter by SIC code

Example:7372

categorystring

Filter by SEC category (Large Accelerated Filer, etc.)

Example:Large Accelerated Filer

entityTypestring

Filter by entity type

Example:Corporation

statestring

Filter by state of incorporation (2-letter code)

Example:CA

hasInsiderTransactions'true' | 'false'

Filter to companies with or without insider transaction history

Response

Paginated list of companies

nextCursorstring nullable required

Cursor for next page, null if no more pages

hasMoreboolean required

Whether more items exist beyond this page

Example response

{
  "items": [
    {
      "cik": 320193,
      "ticker": "AAPL",
      "exchange": "NASDAQ",
      "entityType": "Corporation",
      "category": "Large Accelerated Filer",
      "sicCode": 7372,
      "sicDescription": "Prepackaged Software"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.