Podcast Contacts

GET https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/contacts

Get the contacts for a podcast

Example request

curl -X GET "https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/contacts" \
  -H "Content-Type: application/json" \
  -H "Authorization: YOUR_API_TOKEN"

const options = {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
  }
};

fetch("https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/contacts", options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

import requests

headers = {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
}

response = requests.get("https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/contacts", headers=headers)
print(response.json())

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "YOUR_API_TOKEN");
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

var response = await client.GetAsync("https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/contacts");
var data = await response.Content.ReadAsStringAsync();
Console.WriteLine(data);

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/contacts", nil)
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "YOUR_API_TOKEN")
	
	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

import { PodEngine } from '@podengine/sdk';

const pe = new PodEngine({ apiKey: process.env.PODENGINE_API_KEY });

const data = await pe.podcasts.getPodcastContacts({
  podcastIdOrSlug: 'this-week-in-startups',
});

console.log(data);

import os

from podengine import PodEngine

pe = PodEngine(api_key=os.environ["PODENGINE_API_KEY"])

data = pe.podcasts.get_podcast_contacts(
    podcast_id_or_slug="this-week-in-startups",
)

print(data)

200

Example response

{
  "status": "OK",
  "data": {
    "podcast": {
      "author": "string",
      "authorityScore": {
        "calculatedAt": "2026-01-15T09:30:00.000Z",
        "authorityScore": 0,
        "qualityScore": 0,
        "youtubeScore": 0,
        "socialScore": 0,
        "engagementScore": 0
      },
      "genres": [
        "string"
      ],
      "id": "string",
      "imageUrl": "string",
      "language": "string",
      "lastEpisodePublishedAt": "2026-01-15T09:30:00.000Z",
      "slug": "string",
      "title": "string",
      "titleLatest": "string"
    },
    "podcastContacts": {
      "podcastId": "string",
      "emails": [
        {
          "email": "string",
          "verifiedAt": "2026-01-15T09:30:00.000Z",
          "syntaxValid": true,
          "mxValid": true,
          "deepVerifiedAt": "2026-01-15T09:30:00.000Z",
          "deliverabilityStatus": "valid",
          "deliverabilityReason": "string",
          "isFreeEmailProvider": true,
          "suggestedCorrection": "string"
        }
      ],
      "phoneNumbers": [
        "string"
      ],
      "websites": [
        {
          "url": "string",
          "verified": true,
          "contactUrls": [
            "string"
          ]
        }
      ]
    }
  }
}

Request

Path parameters

podcastIdOrSlugstringrequired

Podengine ID, Apple ID, or slug

Response

200 application/json

statusliteral: OKrequired

dataobjectrequired2 fields

podcastobjectrequired10 fields

authorstringrequirednullable

authorityScoreobjectrequirednullable6 fields

calculatedAtdaterequired

authorityScorenumberrequired

This is the weighted total authority score of the podcast, out of 100

qualityScorenumberrequired

This is the quality score of the podcast, out of 100

youtubeScorenumberrequired

This is the YouTube score of the podcast, out of 100

socialScorenumberrequired

This is the social score of the podcast, out of 100

engagementScorenumberrequired

This is the engagement score of the podcast, out of 100

genresarray of stringrequired

idstringrequired

imageUrlstringrequirednullable

languagestringrequired

lastEpisodePublishedAtdaterequired

slugstringrequired

titlestringrequired

titleLateststringrequired

podcastContactsobjectrequired4 fields

podcastIdstringrequired

emailsarray of objectrequired9 fields

emailstringrequired

The email address associated with the podcast contact

verifiedAtdaterequirednullable

The timestamp when the email was last verified, or null if it has not been verified

syntaxValidbooleanrequirednullable

Whether the email address has valid syntax (e.g. correctly formatted local and domain parts), or null if not yet checked

mxValidbooleanrequirednullable

Whether the email's domain has valid MX records indicating it can receive mail, or null if not yet checked

deepVerifiedAtdaterequirednullable

The timestamp when the email was last deep-verified for deliverability, or null if not run

deliverabilityStatusenumrequirednullable

Deep deliverability status: valid, invalid, catch-all, unknown, spamtrap, abuse, or do_not_mail

validinvalidcatch-allunknownspamtrapabusedo_not_mail

deliverabilityReasonstringrequirednullable

Sub-classification providing more detail on the deliverability result

isFreeEmailProviderbooleanrequirednullable

Whether the address belongs to a known free-email provider (e.g. gmail, yahoo)

suggestedCorrectionstringrequirednullable

Suggested correction for likely typos, e.g. gmial.com -> gmail.com

phoneNumbersarray of stringrequired

websitesarray of objectrequired3 fields

urlstringrequired

verifiedbooleanrequired

contactUrlsarray of stringrequired