Aggregate Search by Ticker
GET
/api/v1/search/by_ticker
Search transcripts and return per-ticker aggregated counts (how many of a ticker's calls in the window mentioned the query). Optional ticker filter lets you scope to a known universe (e.g. Fortune 500). The `results` leaderboard is capped at `limit` (max 500), but `total_companies` and `total_calls` always reflect the full matching set independent of limit. Pro/Enterprise only.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
q required |
query | string | Search query (required, 2+ chars) |
tickers optional |
query | string | Comma-separated ticker list to scope the search (e.g. NVDA,MSFT,AAPL). Omit to scan all. |
sector optional |
query | string | Filter by GICS sector |
industry optional |
query | string | Filter by industry |
date_from optional |
query | string | YYYY-MM-DD lower bound |
date_to optional |
query | string | YYYY-MM-DD upper bound |
limit optional |
query | integer | - |
Example request
curl "https://earningsapi.io/api/v1/search/by_ticker?q=data+center" \ -H "X-API-Key: YOUR_API_KEY"
Authenticate with your API key in the X-API-Key header (or api_key query parameter). Get a key on the pricing page. Try any endpoint interactively in the Swagger console, and see the full OpenAPI spec.