Transcripts

Transcripts are the core content unit of the Alium platform. Each transcript represents a structured interview with a buyer about their tech stack, vendor opinions, and strategic priorities.

List transcripts

GET /api/v1/transcripts

Search and filter transcripts. Results are paginated and sorted by relevance (default) or recency.

note

The list endpoint excludes full transcript text and summaries for performance. Use the detail endpoint to retrieve those fields.

Query parameters

Parameter	Type	Description
q	string	Full-text search query
page	integer	Page number (default: 1)
per_page	integer	Results per page (default: 20, max: 50)
sort_by	string	relevance (default) or recency
in_market_for[]	string[]	Filter by use case names
industry[]	string[]	Filter by buyer industry names
vendors[]	string[]	Filter by vendor company names
products[]	string[]	Filter by product names
buyers[]	string[]	Filter by buyer company names
mgmt_level[]	string[]	Filter by management level
revenue	string	Revenue range, e.g. 1000000;50000000
employee_count	string	Employee count range

tip

Filter values use names, not IDs. Use the reference endpoints to discover valid values. Unrecognized filter values are silently ignored.

Example request

curl -H "Authorization: Token YOUR_API_KEY" \
  "https://app.alium.io/api/v1/transcripts?q=marketing&per_page=10"

Filter examples

Search for transcripts where the buyer is in market for "Email Marketing" or "CDP":

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

Filter by vendor and sort by recency:

curl -H "Authorization: Token YOUR_API_KEY" \
  "https://app.alium.io/api/v1/transcripts?vendors[]=Salesforce&sort_by=recency"

Response

Each item in data is a flattened transcript with the same field layout as the detail endpoint, minus buyer_perspective, quick_study, and full_transcript.

{
  "data": [
    {
      "id": "abc123",
      "url": "https://app.alium.io/transcripts/abc123",
      "title": "Interview with VP Marketing at Acme Corp",
      "date": "March 2024",
      "publish_date": "2024-03-15",
      "management_level": "VP",
      "department": "Marketing",
      "opted_into_intros": true,
      "company": "Acme Corp",
      "company_hq": "California",
      "company_domain_name": "acme.com",
      "company_revenue": "$100M-$500M",
      "company_employee_count": "1,001-5,000",
      "company_industries": ["Retail > Apparel"],
      "in_market_for": ["Email Marketing", "CDP"],
      "strategic_priorities": ["Personalization", "Customer retention"],
      "tech_stack": [
        {
          "product": "Salesforce Marketing Cloud",
          "vendor": "Salesforce",
          "vendor_domain_name": "salesforce.com",
          "rating": 8,
          "use_cases": ["Email campaigns"]
        }
      ],
      "icp_matches": 2,
      "icp_matched_attributes": [
        {"revenue": "$100M+"},
        {"industry": "Retail"}
      ]
    }
  ],
  "meta": {
    "total_count": 142,
    "page": 1,
    "per_page": 10
  }
}

Response fields

Item fields match the detail endpoint response fields, except that buyer_perspective, quick_study, and full_transcript are omitted. Pagination metadata:

Field	Type	Description
meta.total_count	integer	Total number of matching transcripts
meta.page	integer	Current page number
meta.per_page	integer	Results per page

---

Get a transcript

GET /api/v1/transcripts/:id

Retrieve full details for a single transcript, including the full transcript text, quick study Q&A, tech stack with ratings, and buyer perspective.

Example request

curl -H "Authorization: Token YOUR_API_KEY" \
  "https://app.alium.io/api/v1/transcripts/abc123"

Response

{
  "id": "abc123",
  "title": "Interview with VP Marketing at Acme Corp",
  "publish_date": "2024-03-15",
  "date": "March 2024",
  "management_level": "VP",
  "department": "Marketing",
  "opted_into_intros": true,
  "company": "Acme Corp",
  "company_hq": "California",
  "company_domain_name": "acme.com",
  "company_revenue": "$100M-$500M",
  "company_employee_count": "1,001-5,000",
  "company_industries": ["Retail > Apparel"],
  "in_market_for": ["Email Marketing", "CDP"],
  "strategic_priorities": ["Personalization", "Customer retention"],
  "buyer_perspective": "The VP discussed their focus on...",
  "tech_stack": [
    {
      "product": "Salesforce Marketing Cloud",
      "vendor": "Salesforce",
      "vendor_domain_name": "salesforce.com",
      "rating": 4,
      "use_cases": ["Email campaigns", "Journey builder"]
    }
  ],
  "quick_study": "Q: What are your top priorities?\nA: ...",
  "full_transcript": "Q: Can you tell me about your role?\nA: ...",
  "icp_matches": 2,
  "icp_matched_attributes": [
    {"revenue": "$100M+"},
    {"industry": "Retail"}
  ],
  "url": "https://app.alium.io/transcripts/abc123"
}

Response fields

Field	Type	Description
id	string	Unique transcript identifier
title	string	Interview title
publish_date	string	ISO 8601 publish date
date	string	Display date (month + year)
management_level	string	Interviewee's management level
department	string	Interviewee's department
opted_into_intros	boolean	Whether the buyer opted into introductions
company	string	Buyer's company name (omitted when the buyer requested anonymity)
company_hq	string	Company headquarters — US state for US companies, country otherwise
company_domain_name	string	Company website domain (omitted when the buyer requested anonymity)
company_revenue	string	Bucketed revenue range
company_employee_count	string	Bucketed employee count range
company_industries	string[]	Buyer's industries. Nested industries are joined as "Parent > Child"
in_market_for	string[]	Use cases the buyer is evaluating
strategic_priorities	string[]	Buyer's stated strategic priorities
buyer_perspective	string	AI-generated summary of the buyer's perspective
tech_stack	object[]	Vendors and products in the buyer's tech stack
tech_stack[].product	string	Product name
tech_stack[].vendor	string	Vendor company name
tech_stack[].vendor_domain_name	string	Vendor's website domain
tech_stack[].rating	integer | null	Buyer's rating of the product on a 1–10 scale, or null if the buyer did not rate it
tech_stack[].use_cases	string[]	How the buyer uses this product
quick_study	string	AI-generated executive summary Q&A
full_transcript	string	Complete interview transcript text
icp_matches	integer | null	Count of your team's ICP attributes that matched this transcript. 0 if your team has ICP attributes but none matched. null if your team has no ICP attributes configured or this transcript has not been scored yet.
icp_matched_attributes	object[]	The ICP attributes that matched, as {type: value} pairs (e.g. {"industry": "Retail"}). Empty array if none matched.
url	string	Direct link in the Alium app