Podcast Social Media

GET https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/social-media

Get the social media data for a podcast

Example request

curl -X GET "https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/social-media" \
  -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/social-media", 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/social-media", 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/social-media");
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/social-media", 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.getPodcastSocialMediaDetails({
  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_social_media_details(
    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"
    },
    "socialMediaData": {
      "podcastId": "string",
      "socialMediaLinks": [
        {
          "socialMediaType": "beehiiv",
          "url": "https://example.com",
          "sources": [
            "apple-podcasts"
          ]
        }
      ],
      "facebookPageData": [
        {
          "facebookPageId": "string",
          "profilePhotoUrl": "string",
          "name": "string",
          "followers": 0,
          "likes": 0,
          "following": 0,
          "talkingAboutCount": 0,
          "facebookPageUrl": "string",
          "scrapedAt": "2026-01-15T09:30:00.000Z"
        }
      ],
      "instagramData": [
        {
          "profileId": 0,
          "followers": 0,
          "following": 0,
          "posts": 0,
          "instagramProfileName": "string",
          "profilePhotoUrl": "string",
          "scrapedAt": "2026-01-15T09:30:00.000Z"
        }
      ],
      "linkedInCompanyData": [
        {
          "scrapedAt": "2026-01-15T09:30:00.000Z",
          "linkedInCompanyId": "string",
          "linkedInUrl": "string",
          "name": "string",
          "countryCode": "string",
          "followers": 0,
          "employeesInLinkedin": 0,
          "about": "string",
          "description": "string",
          "companySize": "string",
          "industries": "string",
          "logoImageUrl": "string",
          "mostRecentUpdate": {
            "postId": "string",
            "likesCount": 0,
            "commentsCount": 0,
            "title": "string",
            "text": "string",
            "postUrl": "string",
            "date": "2026-01-15T09:30:00.000Z"
          }
        }
      ],
      "linkedInPersonData": [
        {
          "scrapedAt": "2026-01-15T09:30:00.000Z",
          "name": "string",
          "profilePhotoUrl": "string",
          "linkedInProfileId": "string",
          "linkedInNumericId": 0,
          "avatarUrl": "string",
          "city": "string",
          "countryCode": "string",
          "description": "string",
          "about": "string",
          "location": "string",
          "followerCount": 0,
          "connectionsCount": 0,
          "recommendationsCount": 0
        }
      ],
      "tiktokData": [
        {
          "accountId": "string",
          "awgEngagementRate": 0,
          "biography": "string",
          "commentEngagementRate": 0,
          "dateJoined": "2026-01-15T09:30:00.000Z",
          "followers": 0,
          "following": 0,
          "isPrivate": true,
          "isVerified": true,
          "likeEngagementRate": 0,
          "likes": 0,
          "nickname": "string",
          "handle": "string",
          "profilePicUrl": "https://example.com",
          "videosCount": 0,
          "scrapedAt": "2026-01-15T09:30:00.000Z"
        }
      ],
      "twitterData": [
        {
          "profileId": "string",
          "profileName": "string",
          "profileUrl": "https://example.com",
          "profileImageUrl": "https://example.com",
          "biography": "string",
          "followingCount": 0,
          "followerCount": 0,
          "postsCount": 0,
          "dateJoined": "2026-01-15T09:30:00.000Z",
          "scrapedAt": "2026-01-15T09:30:00.000Z"
        }
      ]
    }
  }
}

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

socialMediaDataobjectrequired8 fields

podcastIdstringrequired

socialMediaLinksarray of objectrequired3 fields

socialMediaTypeenumrequired

Social platform associated with the profile URL.

beehiivbehanceblueskydiscordfacebookgithubinstagramlinkedinlinktreemastodonmediumpatreonpinterestredditsnapchatsoundcloudsubstackthreadstiktoktumblrtwitchtwittervimeowhatsappyoutube

urlstringrequiredurl

Full URL of the social media profile.

sourcesarray of enumrequired

apple-podcastsbright-data-datasetgoogle-searchlinktreepodcast-websitepodchaserrephonicrssyoutube-channel-linksyoutube-episode-searchyoutube-serpyoutube-api-search

facebookPageDataarray of objectrequired9 fields

facebookPageIdstringrequired

profilePhotoUrlstringrequirednullable

namestringrequired

followersnumberrequiredmin 0

likesnumberrequiredmin 0

followingnumberrequiredmin 0

talkingAboutCountnumberrequirednullable

facebookPageUrlstringrequired

scrapedAtdaterequired

instagramDataarray of objectrequired7 fields

profileIdnumberrequired

followersnumberrequired

followingnumberrequired

postsnumberrequired

instagramProfileNamestringrequired

profilePhotoUrlstringrequirednullable

scrapedAtdaterequired

linkedInCompanyDataarray of objectrequired13 fields

scrapedAtdaterequired

linkedInCompanyIdstringrequired

linkedInUrlstringrequired

namestringrequired

countryCodestringrequirednullable

followersnumberrequirednullable

employeesInLinkedinnumberrequired

aboutstringrequirednullable

descriptionstringrequirednullable

companySizestringrequirednullable

industriesstringrequirednullable

logoImageUrlstringrequirednullable

mostRecentUpdateobjectrequirednullable7 fields

postIdstringrequired

likesCountnumberrequired

commentsCountnumberrequired

titlestringrequired

textstringrequired

postUrlstringrequired

datedaterequired

linkedInPersonDataarray of objectrequired14 fields

scrapedAtdaterequired

namestringrequired

profilePhotoUrlstringrequirednullable

linkedInProfileIdstringrequired

linkedInNumericIdnumberrequired

avatarUrlstringrequirednullable

citystringrequirednullable

countryCodestringrequirednullable

descriptionstringrequirednullable

aboutstringrequirednullable

locationstringrequirednullable

followerCountnumberrequired

connectionsCountnumberrequired

recommendationsCountnumberrequired

tiktokDataarray of objectrequired16 fields

accountIdstringrequired

awgEngagementRatenumberrequirednullable

biographystringrequirednullable

commentEngagementRatenumberrequirednullable

dateJoineddaterequired

followersnumberrequired

followingnumberrequired

isPrivatebooleanrequired

isVerifiedbooleanrequired

likeEngagementRatenumberrequirednullable

likesnumberrequired

nicknamestringrequired

handlestringrequired

profilePicUrlstringrequirednullableurl

videosCountnumberrequired

scrapedAtdaterequired

twitterDataarray of objectrequired10 fields

profileIdstringrequired

profileNamestringrequired

profileUrlstringrequiredurl

profileImageUrlstringrequirednullableurl

biographystringrequirednullable

followingCountnumberrequiredmin 0

followerCountnumberrequiredmin 0

postsCountnumberrequiredmin 0

dateJoineddaterequirednullable

scrapedAtdaterequired