Podseeker API

The podcast contact and outreach API. Built for automation.

Podseeker provides programmatic access to a curated database of active, contactable podcasts with verified contact emails, booking difficulty ratings, host information, and audience data. Dormant and low-quality shows are filtered out so agents only work with podcasts worth pitching.

Authentication

All requests require a Bearer token in the Authorization header.

Authorization: Bearer ps_your_api_key_here

Get your API key by signing up and selecting the API plan. You can manage your keys at any time in Account Settings → API.

Pricing & Credits

1 credit = search or detail call. 10 credits = contact enrichment (refunded automatically if it fails or finds no contacts). 100 free credits to try. Usage headers are included in every response, and GET /api/v1/usage returns your authoritative balance any time.

# Response headers
X-Credits-Used: 142
X-Credits-Included: 2000
X-Credits-Remaining: 1858
X-Overage-Credits: 0
X-Overage-Charge: 0.0

Rate Limits

60 requests per minute per organization. Exceeding this returns 429 Too Many Requests with a Retry-After: 60 header.

Search for podcasts matching a query with optional filters. Returns up to 50 results per page.

Parameters

Example Request

curl -H "Authorization: Bearer ps_your_key" \
  "https://app.podseeker.co/api/v1/podcasts/search?query=entrepreneurship&active=true&has_guest=true&has_email=true"

Example Response

{
  "podcasts": [
    {
      "id": 625373,
      "title": "Highest Self Podcast",
      "publisher": "Sahara Rose",
      "description": "A wellness and personal growth show...",
      "artwork_url": "https://...",
      "topics": ["Wellness", "Entrepreneurship", "Mindset"],
      "location": "USA",
      "estimated_listeners": 48000, // rounded estimate per episode
      "episode_count": 520,
      "episode_frequency": "weekly",
      "latest_episode_date": "2026-05-10T07:00:00.000Z",
      "rating": 4.89,
      "has_guests": true,
      "has_email": true,
      "booking_difficulty": "medium"
    }
  ],
  "total": 5000,
  "page": 0,
  "per_page": 50,
  "total_pages": 100
}

Get full details for a single podcast, including verified contact emails, official website, RSS feed, host bios, guest caliber requirements, and social stats.

Example Request

curl -H "Authorization: Bearer ps_your_key" \
  "https://app.podseeker.co/api/v1/podcasts/625373"

Example Response

{
  "podcast": {
    "id": 625373,
    "title": "Highest Self Podcast",
    "publisher": "Sahara Rose",
    "description": "A wellness and personal growth show...",
    "website_url": "https://sahararose.com",
    "rss_url": "https://...",
    "topics": ["Wellness", "Entrepreneurship", "Mindset"],
    "categories": ["Health & Fitness", "Self-Improvement"],
    "location": "USA",
    "estimated_listeners": 48000, // rounded estimate per episode
    "episode_count": 520,
    "episode_frequency": "weekly",
    "rating": 4.89,
    "booking_difficulty": "medium",
    "hosts": [
      {
        "full_name": "Sahara Rose",
        "role": "Host",
        "professional_bio": "Bestselling author and wellness expert..."
      }
    ],
    "guest_caliber": {
      "prominence_level": "established_expert",
      "booking_difficulty": "medium",
      "typical_credentials": "Authors, coaches, and wellness practitioners...",
      "typical_achievements": ["published books", "coaching practice"]
    },
    "contacts": {
      "primary_email": "[email protected]",
      "all_emails": ["[email protected]"],
      "has_contact_form": true,
      "enriched_contacts": null // null if not enriched, or object with people array
    },
    "social": {
      "youtube_subscribers": 185000,
      "instagram_followers": 1420000
    }
  }
}

Trigger contact enrichment for a podcast. Finds direct contacts (hosts, producers, bookers) with emails. Costs 10 credits. Takes 60-120 seconds. Check GET /podcasts/:id first - if enriched_contacts already has data, you may not need to re-enrich. If an enrichment fails or finds no contacts, the 10 credits are automatically refunded - you only pay when it produces contacts. A successful enrichment enters a 30-day cooldown; re-enriching before then returns a 429.

Example Request

curl -X POST -H "Authorization: Bearer ps_your_key" \
  "https://app.podseeker.co/api/v1/podcasts/625373/enrich"

Example Response 202 Accepted

{
  "enrichment_id": "enr_42",
  "status": "enriching",
  "estimated_seconds": 120,
  "podcast_id": 625373
}

After enrichment completes GET /podcasts/:id returns

{
  "contacts": {
    "primary_email": "[email protected]",
    "all_emails": ["[email protected]"],
    "has_contact_form": true,
    "enriched_contacts": {
      "last_updated_at": "2026-05-22",
      "people": [
        {
          "name": "Sahara Rose",
          "role": "Host / Founder",
          "email": "[email protected]",
          "linkedin_url": "https://linkedin.com/in/sahararose",
          "contact_confidence": "very_high"
        }
      ]
    }
  }
}

Contact Confidence Levels

Poll for enrichment completion. Free - no credit cost. Use the enrichment_id returned by the enrich endpoint. Status is processing, completed, or failed. When no contacts are found or the run fails, the response includes a note confirming the 10 credits were refunded.

Example Request

curl -H "Authorization: Bearer ps_your_key" \
  "https://app.podseeker.co/api/v1/enrichments/enr_42"

Response - Processing

{
  "enrichment_id": "enr_42",
  "status": "processing",
  "podcast_id": 625373,
  "estimated_seconds": 120
}

Response - Completed

{
  "enrichment_id": "enr_42",
  "status": "completed",
  "podcast_id": 625373
}

Response - Completed, no contacts 10 credits refunded

{
  "enrichment_id": "enr_42",
  "status": "completed",
  "podcast_id": 625373,
  "note": "No direct contacts found for this podcast. The 10 credits for this enrichment were refunded."
}

Response - Failed 10 credits refunded

{
  "enrichment_id": "enr_42",
  "status": "failed",
  "podcast_id": 625373,
  "note": "Enrichment failed. The 10 credits for this enrichment were refunded. Please retry."
}

Once completed, fetch the podcast detail (GET /podcasts/:id) to get the enriched contacts in the response.

Your current credit balance, on demand. Free - no credit cost - and strongly consistent (it reads the committed ledger). Use this to check your balance any time instead of reading it off another call's headers - ideal if you meter usage on behalf of your own customers.

Example Request

curl -H "Authorization: Bearer ps_your_key" \
  "https://app.podseeker.co/api/v1/usage"

Example Response

{
  "credits_used": 142,
  "credits_included": 2000,
  "credits_remaining": 1858,
  "overage_credits": 0,
  "overage_charge": 0.0,
  "plan": "API Monthly",
  "status": "active",
  "period_end": "2026-07-15T00:00:00Z"
}

On a paid plan, period_end is when your monthly credits reset. It's null during a trial, since trial credits are a fixed allotment with no scheduled reset - you move to the paid plan when you use them up.

Typical Agent Workflow

1. 1

   Search for podcasts matching your client's niche

   GET /podcasts/search?query=leadership&has_email=true&active=true
2. 2

   Select best fits based on booking difficulty, audience size, and guest caliber

   Match your credentials to the podcast's typical guest profile for higher success rates

3. 3

   Get full details for selected podcasts

   GET /podcasts/:id
4. 4

   Enrich contacts for direct outreach (optional, 10 credits)

   POST /podcasts/:id/enrich → poll GET /enrichments/:id → re-fetch GET /podcasts/:id
5. 5

   Use contacts and host information to craft personalized pitches

   Reference the host by name, mention relevant recent topics, and match your client's credentials to the show's guest caliber

Error Codes