# Podcast Social Media > Pod Engine API endpoint reference, optimized for LLM consumption. > Auto-generated from the source-of-truth endpoint registry. > > Category: Podcasts > Source: https://www.podengine.ai/api-docs/get-podcast-social-media.md > Interactive HTML docs: https://www.podengine.ai/api-docs/get-podcast-social-media > Full API reference (all endpoints): https://www.podengine.ai/api-docs/llms.txt **Base URL:** `http://localhost:4000` **Auth:** Requires a Bearer token: `Authorization: Bearer YOUR_API_KEY` --- #### GET /api/v1/podcasts/:podcastIdOrSlug/social-media **Podcast Social Media** Get the social media data for a podcast ```bash curl -X GET "http://localhost:4000/api/v1/podcasts/this-week-in-startups/social-media" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_API_KEY" ``` **Path parameters schema:** ```json { "type": "object", "properties": { "podcastIdOrSlug": { "type": "string", "description": "Podengine ID, Apple ID, or slug" } }, "required": [ "podcastIdOrSlug" ], "additionalProperties": false } ``` **Response schema:** ```json { "type": "object", "properties": { "status": { "type": "string", "enum": [ "OK" ] }, "data": { "type": "object", "properties": { "podcast": { "type": "object", "properties": { "author": { "nullable": true, "type": "string" }, "authorityScore": { "nullable": true, "type": "object", "properties": { "calculatedAt": {}, "authorityScore": { "type": "number", "description": "This is the weighted total authority score of the podcast, out of 100" }, "qualityScore": { "type": "number", "description": "This is the quality score of the podcast, out of 100" }, "youtubeScore": { "type": "number", "description": "This is the YouTube score of the podcast, out of 100" }, "socialScore": { "type": "number", "description": "This is the social score of the podcast, out of 100" }, "engagementScore": { "type": "number", "description": "This is the engagement score of the podcast, out of 100" } }, "required": [ "calculatedAt", "authorityScore", "qualityScore", "youtubeScore", "socialScore", "engagementScore" ], "additionalProperties": false }, "genres": { "type": "array", "items": { "type": "string" } }, "id": { "type": "string" }, "imageUrl": { "nullable": true, "type": "string" }, "language": { "type": "string" }, "lastEpisodePublishedAt": {}, "slug": { "type": "string" }, "title": { "type": "string" }, "titleLatest": { "type": "string" } }, "required": [ "author", "authorityScore", "genres", "id", "imageUrl", "language", "lastEpisodePublishedAt", "slug", "title", "titleLatest" ], "additionalProperties": false }, "socialMediaData": { "type": "object", "properties": { "podcastId": { "type": "string" }, "socialMediaLinks": { "type": "array", "items": { "type": "object", "properties": { "socialMediaType": { "type": "string", "enum": [ "beehiiv", "behance", "bluesky", "discord", "facebook", "github", "instagram", "linkedin", "linktree", "mastodon", "medium", "patreon", "pinterest", "reddit", "snapchat", "soundcloud", "substack", "threads", "tiktok", "tumblr", "twitch", "twitter", "vimeo", "whatsapp", "youtube" ] }, "url": { "type": "string", "format": "uri" }, "sources": { "type": "array", "items": { "type": "string", "enum": [ "apple-podcasts", "bright-data-dataset", "google-search", "linktree", "podcast-website", "podchaser", "rephonic", "rss" ] } } }, "required": [ "socialMediaType", "url", "sources" ], "additionalProperties": false } }, "facebookPageData": { "type": "array", "items": { "type": "object", "properties": { "facebookPageId": { "type": "string" }, "profilePhotoUrl": { "nullable": true, "type": "string" }, "name": { "type": "string" }, "followers": { "type": "number", "minimum": 0 }, "likes": { "type": "number", "minimum": 0 }, "following": { "type": "number", "minimum": 0 }, "talkingAboutCount": { "nullable": true, "type": "number" }, "facebookPageUrl": { "type": "string" }, "scrapedAt": {} }, "required": [ "facebookPageId", "profilePhotoUrl", "name", "followers", "likes", "following", "talkingAboutCount", "facebookPageUrl", "scrapedAt" ], "additionalProperties": false } }, "instagramData": { "type": "array", "items": { "type": "object", "properties": { "profileId": { "type": "number" }, "followers": { "type": "number" }, "following": { "type": "number" }, "posts": { "type": "number" }, "instagramProfileName": { "type": "string" }, "profilePhotoUrl": { "nullable": true, "type": "string" }, "scrapedAt": {} }, "required": [ "profileId", "followers", "following", "posts", "instagramProfileName", "profilePhotoUrl", "scrapedAt" ], "additionalProperties": false } }, "linkedInCompanyData": { "type": "array", "items": { "type": "object", "properties": { "scrapedAt": {}, "linkedInCompanyId": { "type": "string" }, "linkedInUrl": { "type": "string" }, "name": { "type": "string" }, "countryCode": { "nullable": true, "type": "string" }, "followers": { "type": "number" }, "employeesInLinkedin": { "type": "number" }, "about": { "nullable": true, "type": "string" }, "description": { "nullable": true, "type": "string" }, "companySize": { "nullable": true, "type": "string" }, "industries": { "nullable": true, "type": "string" }, "logoImageUrl": { "nullable": true, "type": "string" }, "mostRecentUpdate": { "nullable": true, "type": "object", "properties": { "postId": { "type": "string" }, "likesCount": { "type": "number" }, "commentsCount": { "type": "number" }, "title": { "type": "string" }, "text": { "type": "string" }, "postUrl": { "type": "string" }, "date": {} }, "required": [ "postId", "likesCount", "commentsCount", "title", "text", "postUrl", "date" ], "additionalProperties": false } }, "required": [ "scrapedAt", "linkedInCompanyId", "linkedInUrl", "name", "countryCode", "followers", "employeesInLinkedin", "about", "description", "companySize", "industries", "logoImageUrl", "mostRecentUpdate" ], "additionalProperties": false } }, "linkedInPersonData": { "type": "array", "items": { "type": "object", "properties": { "scrapedAt": {}, "name": { "type": "string" }, "profilePhotoUrl": { "nullable": true, "type": "string" }, "linkedInProfileId": { "type": "string" }, "linkedInNumericId": { "type": "number" }, "avatarUrl": { "nullable": true, "type": "string" }, "city": { "nullable": true, "type": "string" }, "countryCode": { "nullable": true, "type": "string" }, "description": { "nullable": true, "type": "string" }, "about": { "nullable": true, "type": "string" }, "location": { "nullable": true, "type": "string" }, "followerCount": { "type": "number" }, "connectionsCount": { "type": "number" }, "recommendationsCount": { "type": "number" } }, "required": [ "scrapedAt", "name", "profilePhotoUrl", "linkedInProfileId", "linkedInNumericId", "avatarUrl", "city", "countryCode", "description", "about", "location", "followerCount", "connectionsCount", "recommendationsCount" ], "additionalProperties": false } }, "tiktokData": { "type": "array", "items": { "type": "object", "properties": { "accountId": { "type": "string" }, "awgEngagementRate": { "nullable": true, "type": "number" }, "biography": { "nullable": true, "type": "string" }, "commentEngagementRate": { "nullable": true, "type": "number" }, "dateJoined": {}, "followers": { "type": "number" }, "following": { "type": "number" }, "isPrivate": { "type": "boolean" }, "isVerified": { "type": "boolean" }, "likeEngagementRate": { "nullable": true, "type": "number" }, "likes": { "type": "number" }, "nickname": { "type": "string" }, "handle": { "type": "string" }, "profilePicUrl": { "nullable": true, "type": "string", "format": "uri" }, "videosCount": { "type": "number" }, "scrapedAt": {} }, "required": [ "accountId", "awgEngagementRate", "biography", "commentEngagementRate", "dateJoined", "followers", "following", "isPrivate", "isVerified", "likeEngagementRate", "likes", "nickname", "handle", "profilePicUrl", "videosCount", "scrapedAt" ], "additionalProperties": false } }, "twitterData": { "type": "array", "items": { "type": "object", "properties": { "profileId": { "type": "string" }, "profileName": { "type": "string" }, "profileUrl": { "type": "string", "format": "uri" }, "profileImageUrl": { "nullable": true, "type": "string", "format": "uri" }, "biography": { "nullable": true, "type": "string" }, "followingCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "followerCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "postsCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "dateJoined": { "nullable": true }, "scrapedAt": {} }, "required": [ "profileId", "profileName", "profileUrl", "profileImageUrl", "biography", "followingCount", "followerCount", "postsCount", "dateJoined", "scrapedAt" ], "additionalProperties": false } } }, "required": [ "podcastId", "socialMediaLinks", "facebookPageData", "instagramData", "linkedInCompanyData", "linkedInPersonData", "tiktokData", "twitterData" ], "additionalProperties": false } }, "required": [ "podcast", "socialMediaData" ], "additionalProperties": false } }, "required": [ "status", "data" ], "additionalProperties": false } ``` --- ## See also - All endpoints in one file: https://www.podengine.ai/api-docs/llms.txt - Full reference with every schema inlined: https://www.podengine.ai/api-docs/llms-full.txt - OpenAPI 3.1 spec: https://www.podengine.ai/api-docs/openapi.json - Get an API key: https://www.podengine.ai/get-started - Support: support@podengine.ai