API Reference

The Sponsorable API provides programmatic access to our database of podcast sponsors and sponsorships. Use it to integrate sponsor data into your applications, build custom reports, or power your own tools.

Overview

API access is not available on all plans. Contact us to learn more about getting access to the Sponsorable API.

Base URL

https://app.sponsorable.com/api

Authentication

The Sponsorable API uses Bearer token authentication. Include your API key in the Authorization header of every request.

HTTP Header 
Authorization: Bearer YOUR_API_KEY

You can obtain an API key from your account settings. Keep your API key secure and never expose it in client-side code or public repositories.

Keep your API key secret. Your API key provides access to your account data. Do not share it in publicly accessible areas such as GitHub or client-side code.

Example Request

curl 
curl https://app.sponsorable.com/api/sponsors \
  -H "Authorization: Bearer YOUR_API_KEY"

Rate Limiting

The API enforces rate limits to ensure fair usage and maintain service stability. Rate limits are applied per organization.

Limit 100 requests per minute
Window 60 seconds (rolling)

When you exceed the rate limit, the API returns a 429 Too Many Requests response with information about when you can retry.

Rate Limit Exceeded Response 429 
{
  "error": "Rate limit exceeded",
  "retry_after": 45,
  "retry_at": "2025-11-23T21:15:00Z"
}

The response includes a Retry-After HTTP header indicating the number of seconds to wait before making another request.

Errors

The Sponsorable API uses conventional HTTP response codes to indicate the success or failure of requests.

Code Description
200 Success - The request completed successfully
401 Unauthorized - Invalid or missing API key
404 Not Found - The requested resource doesn't exist
422 Validation Error - Invalid request parameters
429 Rate Limited - Too many requests
500 Server Error - Something went wrong on our end

Error Response Format

Error responses include an error field describing what went wrong:

Authentication Error 401 
{
  "error": "Invalid API token"
}
GET /api/sponsors

List Sponsors

Returns a paginated list of sponsors matching your search criteria. Use query parameters to filter and search the sponsor database.

Query Parameters

Parameter Type Description
page integer Page number for pagination. Default: 1
limit integer Results per page. Default: 50
search string Full-text search by sponsor name
category string Filter by category slug (e.g., technology, business, comedy)
industry string Filter by industry name. Values must be lowercase and URL encoded (e.g., computer%20software, marketing%20%26%20advertising)
last string Filter by last sponsorship recency: day, week, month, or quarter
podcasts integer Minimum number of podcasts sponsored (1-1,000,000)
sponsorships integer Minimum number of total sponsorships (1-1,000,000)
podcast_sponsored string Filter to sponsors of a specific podcast (by podcast ID)

Example Request

curl 
curl "https://app.sponsorable.com/api/sponsors?page=1&limit=25&search=shopify&category=technology" \
  -H "Authorization: Bearer YOUR_API_KEY"
HTTP 
GET /api/sponsors?page=1&limit=25&search=shopify&category=technology HTTP/1.1
Host: app.sponsorable.com
Authorization: Bearer YOUR_API_KEY

Response

Response 200 
{
  "data": [
    {
      "domain": "shopify.com",
      "name": "Shopify",
      "sponsorships": 842,
      "podcasts": 215,
      "last_sponsorship": "2025-11-20",
      "last_podcast": "How I Built This",
      "industry": "Software",
      "city": "Ottawa",
      "state": "ON",
      "country": "Canada",
      "employees": 10000,
      "description": "Shopify is a commerce platform that allows anyone to set up an online store...",
      "keywords": ["ecommerce", "saas", "retail"],
      "contact_title": "Director of Partnerships",
      "contact_email": "partnerships@shopify.com",
      "contact_first_name": "Jane",
      "contact_last_name": "Smith"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 1,
    "total_results": 1,
    "per_page": 25
  }
}

Response Fields

Field Type Description
domain string Company domain (unique identifier)
name string Company/sponsor name
sponsorships integer Total number of sponsorships
podcasts integer Number of unique podcasts sponsored
last_sponsorship string ISO 8601 date of most recent sponsorship
last_podcast string Name of most recently sponsored podcast
industry string Industry category
city string Headquarters city
state string Headquarters state/province
country string Headquarters country
employees integer Employee count
description string Company description
keywords array Technology/business keywords
contact_title string Contact person's job title
contact_email string Contact person's email
contact_first_name string Contact person's first name
contact_last_name string Contact person's last name
GET /api/sponsors/:domain

Get Sponsor

Retrieves detailed information about a specific sponsor, including their top podcasts, categories, and recent sponsorship activity.

Path Parameters

Parameter Type Description
domain string The sponsor's domain (e.g., shopify.com)

Example Request

curl 
curl https://app.sponsorable.com/api/sponsors/shopify.com \
  -H "Authorization: Bearer YOUR_API_KEY"
HTTP 
GET /api/sponsors/shopify.com HTTP/1.1
Host: app.sponsorable.com
Authorization: Bearer YOUR_API_KEY

Response

Response 200 
{
  "sponsor": {
    "domain": "shopify.com",
    "name": "Shopify",
    "description": "Shopify is a commerce platform that allows anyone to set up an online store...",
    "industry": "Software",
    "keywords": ["ecommerce", "saas", "retail"],
    "city": "Ottawa",
    "state": "ON",
    "country": "Canada",
    "employee_count": 10000,
    "sponsorships": 842,
    "podcasts": 215,
    "repeat_podcasts": 89,
    "last_sponsorship_at": "2025-11-20",
    "linkedin_url": "https://linkedin.com/company/shopify",
    "x_url": "https://x.com/shopify",
    "facebook_url": "https://facebook.com/shopify",
    "contacts": 12
  },
  "top_podcasts": [
    {
      "podcast_id": "podcast_abc123",
      "name": "How I Built This",
      "sponsorships": 48,
      "first_sponsorship": "2021-03-15",
      "last_sponsorship": "2025-11-15"
    },
    {
      "podcast_id": "podcast_def456",
      "name": "The Tim Ferriss Show",
      "sponsorships": 36,
      "first_sponsorship": "2020-08-22",
      "last_sponsorship": "2025-10-28"
    }
  ],
  "top_categories": [
    {
      "slug": "business",
      "name": "Business",
      "sponsorships": 312
    },
    {
      "slug": "technology",
      "name": "Technology",
      "sponsorships": 245
    }
  ],
  "new_podcasts": [
    {
      "podcast_id": "podcast_ghi789",
      "name": "Startup Stories",
      "sponsorships": 2,
      "first_sponsorship": "2025-10-01",
      "last_sponsorship": "2025-11-01"
    }
  ]
}

Response Fields

Sponsor Object

Field Type Description
domain string Company domain (unique identifier)
name string Company/sponsor name
description string Company description
industry string Industry category
keywords array Technology/business keywords
city string Headquarters city
state string Headquarters state/province
country string Headquarters country
employee_count integer Number of employees
sponsorships integer Total sponsorships
podcasts integer Unique podcasts sponsored
repeat_podcasts integer Podcasts sponsored multiple times
last_sponsorship_at string ISO 8601 date of most recent sponsorship
linkedin_url string|null LinkedIn company URL
x_url string|null X (Twitter) URL
facebook_url string|null Facebook URL
contacts integer Number of contacts in database

Top Podcasts & New Podcasts Arrays

Each array contains up to 5 podcast objects:

Field Type Description
podcast_id string Podcast identifier
name string Podcast name
sponsorships integer Number of sponsorships on this podcast
first_sponsorship string ISO 8601 date of first sponsorship
last_sponsorship string ISO 8601 date of most recent sponsorship

Top Categories Array

Contains up to 5 category objects:

Field Type Description
slug string Category slug
name string Category name
sponsorships integer Number of sponsorships in this category

Errors

Sponsor Not Found 404 
{
  "error": "Sponsor not found"
}