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.

Base URL

https://app.podseeker.co/api/v1

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 the API dashboard.

Pricing & Credits

$99

per month

4,000

credits included

No overage

run out early? start a new cycle

1 credit = search, detail, or similar-podcasts call (free when no similar podcasts are returned). 10 credits = contact enrichment (refunded automatically if it fails or finds no contacts). Media list and client calls are free. 10 credits per client recommendation delivered. 100 free credits to try. Usage headers are included in every response, and GET /api/v1/usage returns your authoritative balance any time. There is no overage: a request that needs more credits than you have left returns 402 with "code": "credits_exhausted". An admin can start a new billing cycle on the API page at any time: $99 now, your credits go back to 4,000, and your billing date moves to that day.

# Response headers
X-Credits-Used: 142
X-Credits-Included: 4000
X-Credits-Remaining: 3858

Rate Limits

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

GET

/podcasts/search

Search for podcasts matching a query with optional filters. Returns up to 50 results per page (per_page, default 50). description is the publisher-provided show description; pitching_description is Podseeker's more useful, pitching-oriented description.

Parameters

Parameter Type Description
query string Search term, e.g. "health", "entrepreneurship", "AI"
active boolean Filter for active podcasts (episode within last 2 months)
has_guest boolean Filter for podcasts that accept external guests
has_email boolean Filter for podcasts with verified contact emails
topic string[] Filter by topic tag. Top topics: entrepreneurship, leadership, mental health, wellness, coaching, parenting, finance, real estate. Use query for discovery — topic is for narrowing by exact tag.
location string[] Filter by estimated listener location, among English-speaking markets (not where the host is based): usa, uk, au, ca, ie, sg, nz, za. Also returned as location.
booking_difficulty string[] Filter by difficulty: very_low, low, medium, high, very_high, not_applicable
gender_skew string[] Filter by audience gender: male, female, neutral
listener string[] Filter by listener range: <100, 100-1k, 1k-10k, 10k-100k, 100k-1m, >1m
exclude_topic string[] Leave out shows with a topic tag, e.g. politics
category string[] Filter by podcast category, e.g. Business
exclude_category string[] Leave out a podcast category
recency string[] Latest episode date: lt_1_month, 1_2_months, 2_6_months, 6_12_months, gt_12_months
show_age string[] How long the podcast has existed: new (under 3 months), emerging (3–12 months), established (1–3 years), mature (3–5 years), veteran (over 5 years)
rating string[] Apple Podcasts rating: 4.5-5.0, 4.0-4.5, 3.0-4.0, 1.0-3.0, unrated
youtube_subscribers string[] YouTube subscribers, same ranges as listener
instagram_followers string[] Instagram followers, same ranges as listener
publisher string[] Publisher or network name, as returned in publisher
sort string listeners_desc, listeners_asc, latest_episode_desc, latest_episode_asc, youtube_subscribers_desc, instagram_followers_desc
page integer Page number, from 0. Up to 5,000 results in all (pages 0-99 at 50 per page).
per_page integer Results per page, 1-50 (default 50). Smaller pages suit AI agents; each request is 1 credit whatever its size.

Repeated values of one parameter match any of them; different parameters must all match. Every response also includes facets: counts across the whole result set for each filter, keyed by these parameter names and values (for example "booking_difficulty": {"low": 120, "medium": 98}), so you can see how many shows match each option before narrowing.

Example Request

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

Example Response

{
  "podcasts": [
    {
      "id": 2975520,
      "title": "Public Relations Stories and Strategies",
      "publisher": "Stories and Strategies https://storiesandstrategies.ca/",
      "description": "<p>Every organization has a story people believe about it. Most leaders didn't choose that story. They inherited it, stumbled into it, or lost control of it somewhere along the way.</p><p><br></p><p>Stories and Strategies is the podcast that changes that.</p><p><br></p><p>Host Doug Downs talks wi...",
      "pitching_description": "This interview-led public relations and strategic communications show focuses on organizational narrative, reputation, trust, leadership, and the forces shaping public perception, with recurring guests who are communicators, executives, researchers, strategists, and specialized subject-matter experts. Agencies could credibly pitch senior PR and communications professionals, reputation and crisis specialists, authors, researchers, ethical technology experts, and leaders with relevant organizational insights; booking difficulty is medium because guests need substantive expertise and a clear connection to contemporary communications challenges.",
      "artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts211/v4/d0/40/80/d040808d-2623-1341-88cb-cdc965e72080/mza_11599192601511196625.jpg/100x100bb.jpg",
      "topics": ["Public Relations", "Reputation", "Strategic Communication", "Leadership", "Crisis Management"],
      "location": "Canada",
      "estimated_listeners": 1300,
      "listener_range": "1k-10k",
      "episode_count": 274,
      "episode_frequency": "weekly",
      "latest_episode_date": "2026-08-25T05:00:00.000Z",
      "rating": 4.95,
      "has_guests": true,
      "has_email": true,
      "gender_skew": null,
      "booking_difficulty": "medium"
    }
    // …up to 50 podcasts per page
  ],
  "facets": { … }, // counts for every filter value, described above
  "total": 5000,
  "total_capped": true, // more than 5,000 match
  "page": 0,
  "per_page": 50,
  "total_pages": 100
}
GET

/podcasts/:id

Get full details for a single podcast, including verified contact emails, official website, RSS feed, host bios, guest caliber requirements, and social stats. description is the publisher-provided show description; pitching_description is Podseeker's pitching-oriented description.

Example Request

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

Example Response real response, October 2026

The complete response for Public Relations Stories and Strategies, a weekly PR interview show. Nothing is trimmed except two personal email addresses, which are masked in these docs; your API key returns them in full.

{
  "podcast": {
    "id": 2975520,
    "title": "Public Relations Stories and Strategies",
    "publisher": "Stories and Strategies https://storiesandstrategies.ca/",
    "description": "<p>Every organization has a story people believe about it. Most leaders didn't choose that story. They inherited it, stumbled into it, or lost control of it somewhere along the way.</p><p><br></p><p>Stories and Strategies is the podcast that changes that.</p><p><br></p><p>Host Doug Downs talks with the communicators, executives, and strategists who understand that narrative isn't a marketing function. It's a leadership one. Each episode unpacks what actually shapes reputation, trust, and publ...",
    "pitching_description": "This interview-led public relations and strategic communications show focuses on organizational narrative, reputation, trust, leadership, and the forces shaping public perception, with recurring guests who are communicators, executives, researchers, strategists, and specialized subject-matter experts. Agencies could credibly pitch senior PR and communications professionals, reputation and crisis specialists, authors, researchers, ethical technology experts, and leaders with relevant organizational insights; booking difficulty is medium because guests need substantive expertise and a clear connection to contemporary communications challenges.",
    "artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts211/v4/d0/40/80/d040808d-2623-1341-88cb-cdc965e72080/mza_11599192601511196625.jpg/100x100bb.jpg",
    "website_url": "https://storiesandstrategies.ca/podcast/",
    "rss_url": "https://rss.buzzsprout.com/840088.rss",
    "topics": ["Public Relations", "Reputation", "Strategic Communication", "Leadership", "Crisis Management"],
    "categories": ["Marketing", "Business", "Society & Culture"],
    "location": "Canada",
    "language": "en-us",
    "estimated_listeners": 1300,
    "listener_range": "1k-10k",
    "episode_count": 274,
    "episode_frequency": "weekly",
    "latest_episode_date": "2026-08-25T05:00:00.000Z",
    "earliest_episode_date": "2020-05-10T16:00:00.000Z",
    "rating": 4.95,
    "has_guests": true,
    "gender_skew": null,
    "booking_difficulty": "medium",
    "hosts": [
      {
        "role": "Host",
        "full_name": "Doug Downs",
        "professional_bio": "Doug Downs is a public relations and communications professional who hosts discussions about organizational narrative, reputation, trust, leadership, and strategic communication."
      }
    ],
    "guest_caliber": {
      "prominence_level": "rising_expert",
      "booking_difficulty": "medium",
      "typical_credentials": "Senior or experienced public relations and communications professionals, organizational leaders, researchers, authors, strategists, and specialized experts with practical insight into reputation, leadership, ethics, technology, or public perception.",
      "typical_achievements": [
        "Leadership roles in communications, public relations, academia, or specialized professional practice",
        "Published research, reports, or books relevant to communications and leadership",
        "Practical experience addressing reputation, crisis, polarization, workplace inclusion, or emerging technology"
      ]
    },
    "recent_guests": [
      {
        "full_name": "Colleen Killingsworth",
        "credentials": "Researcher and co-author of Rethinking the Table.",
        "episode_date": "2026-08-25",
        "discussion_topics": "Mentorship in public relations; women’s advancement and leadership in the PR profession."
      },
      {
        "full_name": "Amy Thurlow",
        "credentials": "Researcher and co-author of Rethinking the Table.",
        "episode_date": "2026-08-25",
        "discussion_topics": "Mentorship in public relations; women’s advancement and leadership in the PR profession."
      },
      {
        "full_name": "Matt Collette",
        "credentials": "Sequencr.AI professional associated with the Stratum Platform.",
        "episode_date": "2026-08-18",
        "discussion_topics": "Artificial intelligence for communications teams; reputation monitoring; crisis detection; influencer identification; agentic workflows."
      },
      {
        "full_name": "Colleen Killingsworth",
        "credentials": "Researcher and co-author of Rethinking the Table.",
        "episode_date": "2026-08-11",
        "discussion_topics": "Women’s representation in public relations leadership; sustainable leadership careers; workplace inclusion."
      },
      {
        "full_name": "Amy Thurlow",
        "credentials": "Researcher and co-author of Rethinking the Table.",
        "episode_date": "2026-08-11",
        "discussion_topics": "Women’s representation in public relations leadership; sustainable leadership careers; workplace inclusion."
      },
      {
        "full_name": "Priya Sudarsanam",
        "credentials": "Speech pathologist.",
        "episode_date": "2026-08-04",
        "discussion_topics": "Finding one’s voice; assertiveness; communication and self-expression in midlife."
      },
      {
        "full_name": "Fred Cook",
        "credentials": "Director of the USC Annenberg Center for Public Relations.",
        "episode_date": "2026-07-28",
        "discussion_topics": "Polarization and public relations; crisis management; ethics; public affairs; responsible technology; the future skills of PR professionals."
      }
    ],
    "contacts": {
      "primary_email": "e••••@storiesandstrategies.ca",
      "all_emails": ["e••••@storiesandstrategies.ca", "d••••@storiesandstrategies.ca", "[email protected]"],
      "has_contact_form": null,
      "contact_form_url": null,
      "enriched_contacts": {
        "last_updated_at": "2026-09-06",
        "people": [
          {
            "name": "Emily Page",
            "role": "lead producer / episode bookings",
            "email": "e••••@storiesandstrategies.ca",
            "linkedin_url": null,
            "contact_confidence": "very_high"
          },
          {
            "name": "Doug Downs",
            "role": "host / founder / president",
            "email": "d••••@storiesandstrategies.ca",
            "linkedin_url": "https://ca.linkedin.com/in/dougdowns",
            "contact_confidence": "high"
          },
          {
            "name": "Stories and Strategies Team",
            "role": "general inquiries",
            "email": "[email protected]",
            "linkedin_url": "https://www.linkedin.com/company/stories-and-strategies",
            "contact_confidence": "medium"
          }
        ]
      }
    },
    "social": {
      "youtube_subscribers": null,
      "instagram_followers": null
    }
  }
}

Response Fields

FieldWhat it tells you
itunes_idThe show's Apple Podcasts ID, the number after id in its Apple Podcasts link. Use it to match a show to a row in your own list, or look a show up with GET /podcasts/lookup. Also returned in search results.
has_guestsWhether the show features guests. Search with has_guest=true to require it.
booking_difficultyHow hard the show is to book: very_low, low, medium, high, very_high, or not_applicable.
guest_caliberWhat the show expects from guests: prominence_level, booking_difficulty, typical_credentials, and typical_achievements.
recent_guests[]Recent guests with full_name, credentials, episode_date, and discussion_topics. Use them to judge fit and to reference a recent episode in the pitch.
pitching_descriptionPodseeker's description of the show for pitching: format, recurring guest types, and what makes a credible pitch.
hosts[]Hosts with full_name, role (Host, Co-host, Contributor or Producer), title (their professional title outside the show, or null), and professional_bio. Shows analyzed before November 2026 may have a free-text role and no title.
contacts.primary_email, contacts.all_emailsThe best known email for the show and up to five known emails, best first.
contacts.has_contact_form, contacts.contact_form_urlWhether a contact form was detected on the show website, and the page it is on. Often a general contact page; follow the show's own guest instructions where they exist.
contacts.enriched_contacts.people[]People found by enrichment: name, role, email, linkedin_url (when available), and contact_confidence. null until the show has been enriched.
estimated_listenersRounded estimate of listeners per episode. An estimate, not the publisher's analytics; use it to compare shows. null for shows under 100 listeners per episode, which are too small to estimate precisely.
listener_rangeThe show's range in the listener filter's values: <100, 100-1k, 1k-10k, 10k-100k, 100k-1m, or >1m. null when there is no estimate. Also returned in search results.
latest_episode_date, episode_frequency, episode_countActivity: when the show last published, how often, and how many episodes.
topics, categories, location, language, rating, gender_skew, socialSubject, market, Apple Podcasts rating, audience gender skew when known, and YouTube and Instagram counts when available.
GET

/podcasts/lookup

Get the same full profile as GET /podcasts/:id, found by the show's Apple Podcasts ID instead of its Podseeker ID. Use it to match a list of shows you already have, exactly, without searching titles. 1 credit when the show is found; a show we don't have returns 404 and costs nothing.

Parameters

ParameterDescription
itunes_id requiredThe numeric Apple Podcasts ID: the number after id in the show's Apple Podcasts link. For https://podcasts.apple.com/us/podcast/circle-of-greatness-with-nehemiah-davis/id1451425747 it is 1451425747. A full link or any other value returns 422 with what to send, and costs nothing.

Example Request

curl -H "Authorization: Bearer ps_your_key" \
  "https://app.podseeker.co/api/v1/podcasts/lookup?itunes_id=1451425747"

Returns {"podcast": {...}}, exactly as GET /podcasts/:id does.

GET

/podcasts/:id/similar

Get up to five precomputed podcasts similar to the source podcast, in ranked order. Results include summary data for comparison; call GET /podcasts/:id for full details and contacts on a selected result. If no similar podcasts have been calculated, this endpoint returns an empty podcasts array, does not start background work, and costs nothing. 1 credit when podcasts are returned.

Example Request

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

Example Response

{
  "source_podcast_id": 625373,
  "generated_at": "2026-08-24T07:15:00.000Z",
  "podcasts": [
    {
      "id": 712440,
      "title": "The Wellness Way",
      "publisher": "Alex Morgan",
      "description": "Conversations about living well...",
      "pitching_description": "A guest-led wellness show for experts with practical advice...",
      "estimated_listeners": 25000,
      "listener_range": "10k-100k",
      "has_guests": true,
      "has_email": true,
      "booking_difficulty": "medium",
      "rank": 1
    }
  ]
}
POST

/podcasts/:id/enrich

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/2975520/enrich"

Example Response 202 Accepted

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

After enrichment completes GET /podcasts/:id returns

{
  "contacts": {
    "primary_email": "e••••@storiesandstrategies.ca",
    "all_emails": ["e••••@storiesandstrategies.ca", "d••••@storiesandstrategies.ca", "[email protected]"],
    "has_contact_form": null,
    "contact_form_url": null,
    "enriched_contacts": {
      "last_updated_at": "2026-09-06",
      "people": [
        {
          "name": "Emily Page",
          "role": "lead producer / episode bookings",
          "email": "e••••@storiesandstrategies.ca",
          "linkedin_url": null,
          "contact_confidence": "very_high"
        },
        {
          "name": "Doug Downs",
          "role": "host / founder / president",
          "email": "d••••@storiesandstrategies.ca",
          "linkedin_url": "https://ca.linkedin.com/in/dougdowns",
          "contact_confidence": "high"
        },
        {
          "name": "Stories and Strategies Team",
          "role": "general inquiries",
          "email": "[email protected]",
          "linkedin_url": "https://www.linkedin.com/company/stories-and-strategies",
          "contact_confidence": "medium"
        }
      ]
    }
  }
}

Contact Confidence Levels

LevelDescription
very_highDedicated booker, talent coordinator, or host of small show
highExecutive producer, managing producer
mediumGeneral producer, host on large show
lowTangential role, may not handle inbound
very_lowSound engineer, editor, unlikely to respond to outreach
GET

/enrichments/:enrichment_id

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": 2975520,
  "estimated_seconds": 120
}

Response - Completed

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

Response - Completed, no contacts 10 credits refunded

{
  "enrichment_id": "enr_42",
  "status": "completed",
  "podcast_id": 2975520,
  "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": 2975520,
  "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.

GET

/usage

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": 4000,
  "credits_remaining": 3858,
  "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.

CRUD

/lists

Organize podcasts into named lists, such as one shortlist per client or campaign. These are the same Media Lists as in the Podseeker app: a list your agent builds appears in the app for your team, and lists your team builds in the app are available here. Lists hold podcast IDs only; fetch a podcast's details with GET /podcasts/:id. Media list calls are free.

RequestWhat it does
GET /listsYour organization's lists. Add ?archived=true for archived ones.
POST /listsCreate a list: name, and optionally podcast_ids.
GET /lists/:idThe list and its podcast IDs, 1,000 per page (?page=0, 1, …).
PATCH /lists/:idRename it (name), or archive and restore it (archived: true or false).
DELETE /lists/:idArchive the list. Restore it with PATCH or in the app.
POST /lists/:id/podcastsAdd up to 1,000 podcast_ids per request. Podcasts already on the list are skipped, and IDs we don't recognize are returned.
DELETE /lists/:id/podcastsRemove podcast_ids from the list.

Example Request

curl -X POST -H "Authorization: Bearer ps_your_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "Dr. Chen - leadership shows", "podcast_ids": [3897665, 3992942]}' \
  "https://app.podseeker.co/api/v1/lists"

Example Response 201 Created

{
  "id": 18342,
  "name": "Dr. Chen - leadership shows",
  "podcast_count": 2,
  "archived": false,
  "created_by": "Jordan Lee",
  "created_at": "2026-10-28T10:00:00Z",
  "updated_at": "2026-10-28T10:00:00Z",
  "added": 2,
  "already_in_list": 0,
  "unknown_podcast_ids": []
}

A list belongs to your organization. Requests for a list in another organization return 404.

CRUD

/clients

A client is the person you book on podcasts: their name and a profile describing their expertise, topics, and credentials. These are the same clients as in the Podseeker app. Client calls are free. Recommendations match podcasts to a client's profile and cost 10 credits for each recommendation delivered.

RequestWhat it does
GET /clientsThe clients your key can see.
POST /clientsCreate a client: name and bio (required), website, and visibility (team, the default, or private).
GET /clients/:idOne client, with its topics and recommendations_status.
PATCH /clients/:idUpdate name, bio, website, or visibility.
DELETE /clients/:idDelete the client. Pitches you sent for it are kept, without the client.
POST /clients/:id/recommendationsRequest 1 to 25 new recommendations (count, default 10). 10 credits each, charged up front; any not delivered are refunded automatically.
GET /clients/:id/recommendationsEvery recommendation for the client, newest first: podcast_id, client_fit (0 to 100), client_fit_label, client_fit_reason (one sentence on why), status, and podcast (the same summary search returns). 100 per page. Free.

How it works

  • After you create or update a client, its profile is processed in the background. Until it's ready, recommendations_status is profile_processing and requesting recommendations returns 409. It usually takes under a minute.
  • Requesting recommendations returns 202. Poll GET /clients/:id/recommendations until status is ready. Recommendations skip podcasts already recommended or pitched for that client.
  • Each recommendation includes the podcast's summary. Fetch contacts and the full profile with GET /podcasts/:id (1 credit).
  • Recommendations through the API use API credits only and don't count toward the Podseeker app's monthly recommendations.
  • Who can see a client: a key acts as the teammate who created it, so it sees the same clients they see in the app. Team clients are visible to everyone. A private client is visible only to its manager's keys and admins' keys; a client created with visibility: private is managed by the key's teammate. Only the client's manager or an admin can update or delete it (403 otherwise).

Example Request

curl -X POST -H "Authorization: Bearer ps_your_key" \
  -H "Content-Type: application/json" \
  -d '{"count": 10}' \
  "https://app.podseeker.co/api/v1/clients/1158/recommendations"

Example Response GET /clients/:id/recommendations

{
  "client_id": 1158,
  "status": "ready",
  "recommendations": [
    {
      "podcast_id": 3897665,
      "client_fit": 83,
      "client_fit_label": "high",
      "client_fit_reason": "Credible among this show's founder guests, with a strong growth angle.",
      "status": "active",
      "recommended_at": "2026-10-28T10:00:00Z"
    }
  ],
  "total": 1, "page": 0, "per_page": 1000, "total_pages": 1
}

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

Get Host Emails for a Show List You Already Have

If your agency already keeps its target shows in a spreadsheet or CSV, you don't need to find them again: match each row to Podseeker and write the contacts back. With the Apple Podcasts ID in the sheet, the match is exact.

  1. Get the Apple Podcasts ID into a column. If you have Apple Podcasts links, Google Sheets can pull the ID out: =REGEXEXTRACT(A2, "id(\d+)").
  2. Look up each row: GET /api/v1/podcasts/lookup?itunes_id=<the ID> (1 credit per show found). Rows without an Apple ID: search by title with GET /api/v1/podcasts/search?query=<title> and check the match before using it.
  3. Write back id, hosts[0].full_name, contacts.primary_email, the best person from contacts.enriched_contacts.people, booking_difficulty, and latest_episode_date (so you skip shows that stopped publishing).
  4. Enrich the gaps: for shows with no email or only a generic inbox, POST /api/v1/podcasts/:id/enrich (10 credits, refunded if nothing is found).

Any tool that reads a sheet and sends a web request can run this: n8n (Google Sheets or Read CSV node, then an HTTP Request node), Make (Google Sheets or CSV module, then HTTP), Clay (an HTTP API column on your table), Zapier, or a short script. A 404 means we don't have that show; it costs nothing, so mark the row and move on.

Use Podseeker in Claude, ChatGPT, and Other AI Assistants (MCP)

Podseeker has a remote MCP server, so an AI assistant can search podcasts, open profiles and contacts, and create clients, recommendations, and media lists for you. It is the same API with the same credits: each tool costs what its endpoint costs, and lists and clients stay free.

Server URL: https://app.podseeker.co/mcp

  • Claude (claude.ai and Claude Desktop): Settings → Customize → Connectors → Add → Custom connector. Name it Podseeker, paste the server URL, then click Connect and approve in the Podseeker window that opens. New to Podseeker? Create an account in that window; you start with 100 free API credits and come straight back to approve.
  • ChatGPT: open chatgpt.com/plugins, click Add → Add custom MCP server, name it Podseeker, paste the server URL, choose OAuth for authentication, and confirm. Click Connect and approve in the Podseeker window that opens (it needs your organization's API plan). In a new chat, type @ and pick Podseeker. Custom servers depend on your ChatGPT plan and workspace settings.
  • Claude Code: claude mcp add --transport http podseeker https://app.podseeker.co/mcp --header "Authorization: Bearer ps_your_key"
  • Cursor and other MCP clients: add the server URL as a remote (Streamable HTTP) server with the header Authorization: Bearer ps_your_key.

Tools mirror the endpoints above: search, podcast profiles, Apple Podcasts lookup, similar podcasts, contact enrichment, clients, recommendations, media lists, and usage. Search returns 20 results per page by default. A connected assistant appears on the API page under Connected assistants; Disconnect stops it at once.

Use With n8n, Make, Zapier, or Airtable

The API is plain HTTPS with JSON and a bearer-token header, so any tool that can send a web request can use it. There is no dedicated Podseeker app in these tools; use their HTTP step (n8n's HTTP Request node, Make's HTTP module, or Webhooks by Zapier).

  1. Request: GET https://app.podseeker.co/api/v1/podcasts/search with the header Authorization: Bearer ps_your_key and your filters as query parameters, for example query=public%20relations&active=true&has_guest=true&has_email=true&booking_difficulty=low&booking_difficulty=medium.
  2. Loop: split the podcasts array and call GET /api/v1/podcasts/:id for the shows you want to keep (1 credit each).
  3. Store: write each show to Airtable, Google Sheets, or your CRM: title, booking_difficulty, hosts[0].full_name, the best contact from contacts.enriched_contacts.people or contacts.primary_email, and a recent guest from recent_guests to reference.
  4. Enrich when needed: if a show you want has no email or only a generic inbox, call POST /api/v1/podcasts/:id/enrich (10 credits, refunded if nothing is found), then fetch the podcast again when it completes.
  5. Schedule: run it daily or weekly per client, and check GET /api/v1/usage (free) to watch your credits.

Keep a person in the loop before anything is sent: review the shortlist and drafts, honor opt-outs, and follow the email laws that apply to you.

Data Use

Store the records you pull and use them across all your clients' campaigns, in your own CRM, spreadsheet, or product. No attribution required. You can't resell or republish the raw data as a database product. See section 6 of the Terms.

Error Codes

Code Meaning
401 Invalid or missing API key
403 API key is inactive or revoked
402 Not enough credits left this billing period (credits_exhausted), or API subscription inactive
404 Podcast not found, including an Apple Podcasts ID we don't have. No credit charged.
422 Invalid search or lookup parameter(s). Body includes a details array of {param, given, allowed}. No credit charged.
429 Rate limit exceeded (60 req/min)