---
title: "Aggregate Search by Ticker"
method: GET
path: "/api/v1/search/by_ticker"
tags: ["Search"]
---

# Aggregate Search by Ticker

`GET /api/v1/search/by_ticker`

## Request

- Base URL: `https://earningscalls.dev`
- URL: `https://earningscalls.dev/api/v1/search/by_ticker`
- Auth: API key in header `X-API-Key`

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.

## Query parameters

- `q` string, required
- `tickers` string
- `sector` string
- `industry` string
- `date_from` string, date
- `date_to` string, date
- `limit` integer

## Response `200`

Default Response

---

[API](https://skmtc.dev/earningscalls/apis/earnings-call-transcripts-api.md) · [All operations](https://skmtc.dev/earningscalls/apis/earnings-call-transcripts-api/llms.txt) · [OpenAPI document](https://skmtc.dev/earningscalls/apis/earnings-call-transcripts-api/revisions/00131591f434?raw)