Podcast Reviews

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

Get the reviews for a podcast

Example request

curl -X GET "https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/reviews" \
  -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/reviews", 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/reviews", 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/reviews");
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/reviews", 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.getPodcastReviews({
  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_reviews(
    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"
    },
    "podcastReviews": {
      "podcastId": "string",
      "appleId": 0,
      "spotifyId": "string",
      "applePodcastsReview": {
        "appleId": 0,
        "scrapedAt": "2026-01-15T09:30:00.000Z",
        "country": "string",
        "reviewsCount": 0,
        "rating": 0,
        "oneStarCount": 0,
        "twoStarCount": 0,
        "threeStarCount": 0,
        "fourStarCount": 0,
        "fiveStarCount": 0
      },
      "applePodcastsReviewsByCountry": [
        {
          "appleId": 0,
          "scrapedAt": "2026-01-15T09:30:00.000Z",
          "country": "string",
          "reviewsCount": 0,
          "rating": 0,
          "oneStarCount": 0,
          "twoStarCount": 0,
          "threeStarCount": 0,
          "fourStarCount": 0,
          "fiveStarCount": 0
        }
      ],
      "applePodcastsReviewText": {
        "country": "string",
        "total": 0,
        "limit": 0,
        "offset": 0,
        "reviews": [
          {
            "country": "string",
            "rating": 0,
            "title": "string",
            "body": "string",
            "author": "string",
            "reviewedAt": "2026-01-15T09:30:00.000Z",
            "matchedWords": [
              "string"
            ]
          }
        ]
      },
      "spotifyReview": {
        "spotifyId": "string",
        "scrapedAt": "2026-01-15T09:30:00.000Z",
        "reviewsCount": 0,
        "rating": 0
      },
      "castbox": {
        "scrapedAt": "2026-01-15T09:30:00.000Z",
        "plays": 0,
        "subscribers": 0
      }
    }
  }
}

Request

Path parameters

podcastIdOrSlugstringrequired

Pod Engine ID or slug, Apple Podcasts ID, Spotify show ID, or podcast:guid

Query parameters

countryenum

Apple storefront to scope the aggregate ratings and review text to (us, gb, au, ca). Omit for all storefronts.

usgbauca

limitnumber1 – 100

Maximum number of review-text rows to return (default 25, max 100).

offsetnumbermin 0

Number of review-text rows to skip, for pagination (default 0).

minRatingnumber1 – 5

Only return review text rated at least this many stars (1-5).

maxRatingnumber1 – 5

Only return review text rated at most this many stars (1-5).

qstringmax 200 characters

Full-text search over review titles and text (English stemming, so "rerun" matches "reruns"). Every word must match; use quotes for a phrase and a leading - to exclude a word. Matching words are returned in each review's matchedWords.

sortenum

Order of the review text: newest (default), lowest rating first, or highest rating first. Ties go newest first.

newestlowesthighest

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

podcastReviewsobjectrequired8 fields

podcastIdstringrequired

appleIdnumberrequired

spotifyIdstringrequirednullable

applePodcastsReviewobjectrequirednullable10 fields

appleIdnumberrequired

scrapedAtdaterequired

countrystringrequired

reviewsCountnumberrequired

ratingnumberrequirednullable

oneStarCountnumberrequired

twoStarCountnumberrequired

threeStarCountnumberrequired

fourStarCountnumberrequired

fiveStarCountnumberrequired

applePodcastsReviewsByCountryarray of objectrequired10 fields

appleIdnumberrequired

scrapedAtdaterequired

countrystringrequired

reviewsCountnumberrequired

ratingnumberrequirednullable

oneStarCountnumberrequired

twoStarCountnumberrequired

threeStarCountnumberrequired

fourStarCountnumberrequired

fiveStarCountnumberrequired

applePodcastsReviewTextobjectrequirednullable5 fields

countrystringrequirednullable

totalnumberrequired

limitnumberrequired

offsetnumberrequired

reviewsarray of objectrequired7 fields

countrystringrequired

ratingnumberrequired

titlestringrequired

bodystringrequired

authorstringrequired

reviewedAtdaterequired

matchedWordsarray of string

spotifyReviewobjectrequirednullable4 fields

spotifyIdstringrequired

scrapedAtdaterequired

reviewsCountnumberrequired

ratingnumberrequirednullable

castboxobjectrequirednullable3 fields

scrapedAtdaterequired

playsnumberrequired

subscribersnumberrequired