Reference Endpoints

Use these endpoints to discover valid filter values for the transcript search endpoint. All results are scoped to transcripts provisioned to your team.

info

Reference endpoint responses are cached for 1 hour. Consider caching these on your end as well.

Markets (use cases)

GET /api/v1/markets

Returns the list of use case categories (used with the in_market_for[] filter).

Industries

GET /api/v1/industries

Returns buyer industries (used with the industry[] filter).

Vendors

GET /api/v1/vendors

Returns vendor companies mentioned in transcripts (used with the vendors[] filter). The vendors endpoint returns additional fields beyond the standard name/transcript_count:

{
  "data": [
    {
      "name": "Salesforce",
      "slug": "salesforce",
      "domain_name": "salesforce.com",
      "transcript_count": 52,
      "buyer_count": 38
    }
  ]
}

To access full vendor intelligence (ratings, likes/dislikes, buyer lists), see the Vendor Profiles endpoints.

Products

GET /api/v1/products

Returns software products mentioned in transcripts (used with the products[] filter).

Buyers

GET /api/v1/buyers

Returns buyer companies (used with the accounts[] filter).

Deprecated

This endpoint is superseded by GET /api/v1/accounts, which returns the same companies with slugs, firmographics, industries, and interview counts, plus the full transcript filter surface. /api/v1/buyers keeps serving its current response and now sends Deprecation: true and a Link: </api/v1/accounts>; rel="successor-version" header. No retirement date is set yet; a Sunset header will appear here before one is.

Response format

All reference endpoints return the same structure:

{
  "data": [
    {
      "name": "Email Marketing",
      "transcript_count": 142
    },
    {
      "name": "CDP",
      "transcript_count": 87
    }
  ]
}

Field	Type	Description
name	string	The filter value to use in transcript search queries
transcript_count	integer	Number of transcripts matching this value

Example

# Fetch available markets to use as in_market_for[] filter values
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://app.alium.io/api/v1/markets"

Then use a returned name in a transcript search:

curl -H "Authorization: Token YOUR_API_KEY" \
  "https://app.alium.io/api/v1/transcripts?in_market_for[]=Email+Marketing"