Endpoints

Search

Full-text search across every earnings call transcript.

GEThttps://v2.api.alpha.earningscall.biz/search

Searches the transcript corpus and returns the most relevant calls. Each result includes a relevance score and up to three highlighted snippets showing where the query matched. Filter by company, exchange, year, or quarter to narrow the result set.

Parameters#

ParameterTypeDescription
apikeystringRequiredYour API key.
qstringRequiredThe search query. Required and must be non-empty.
symbolstringOptionalRestrict to a single ticker.
exchangestringOptionalRestrict to a single exchange.
yearintegerOptionalRestrict to a single year.
quarterintegerOptionalRestrict to a single quarter, 1–4.
fromintegerOptionalPagination offset, default 0.
sizeintegerOptionalResult count per page, default 10, max 100 (10 for demo).

Examples#

Search for a phrase#

curl 'https://v2.api.alpha.earningscall.biz/search?apikey=demo&q=AI%20capital%20expenditure&size=5'

Response

{
  "results": [
    {
      "exchange": "NASDAQ",
      "symbol": "AAPL",
      "company_name": "Apple Inc.",
      "year": 2024,
      "quarter": 1,
      "score": 12.345,
      "highlights": [
        "...we are continuing to invest in <em>AI</em> across the company...",
        "...incremental <em>capital expenditure</em> in our data centers..."
      ]
    }
  ],
  "total": 42,
  "from": 0,
  "size": 5,
  "took": 15
}

Filter by company and quarter#

curl 'https://v2.api.alpha.earningscall.biz/search?apikey=demo&q=guidance&exchange=NASDAQ&symbol=AAPL&year=2024&quarter=1'

Response

{
  "results": [
    {
      "exchange": "NASDAQ",
      "symbol": "AAPL",
      "company_name": "Apple Inc.",
      "year": 2024,
      "quarter": 1,
      "score": 8.7,
      "highlights": [
        "...our <em>guidance</em> for the March quarter assumes..."
      ]
    }
  ],
  "total": 1,
  "from": 0,
  "size": 10,
  "took": 8
}

Error responses#

See the Errors page for the full error format. This endpoint can return:

400missing_parameter — Missing or empty `q` parameter.400invalid_parameter — Invalid year, quarter, or pagination value.401invalid_api_key — Auth failure.429rate_limit_exceeded — Plan rate limit exceeded.503service_unavailable — Search backend is not available.