Apple Podcasts Product
Apple Podcasts product endpoint: show metadata plus canonical episodes resolved through the publisher RSS feed.
Run this endpoint
Endpoint
https://scrappa.co/api/apple/app-store/podcasts/product?product_id=1253186678&store=podcasts
https://scrappa.co/api/apple/app-store/podcasts/product?product_id=1253186678&store=podcasts
x-api-key
product_id
= 1253186678
{
"search_parameters": {
"engine": "apple_app_store_details",
"product_id": "284882215",
"store": "apps",
"country": "us"
},
"product": {
"id": "284882215",
"store": "apps",
"title": "Facebook",
"artist": "Meta Platforms, Inc.",
"rating": 2.3,
"rating_count": 1300000,
...
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
5 optional filters available.
string
Required
Apple product id (numeric adam id, e.g. 284882215; UMC ids also accepted for movies/TV).
1253186678
string
Optional
Apple store vertical: apps, mac, books, audiobooks, movies, tv, music, or podcasts.
podcasts
string
Optional
Two-letter Apple storefront country code (e.g. us, gb, de). Defaults to us.
US
string
Optional
TV season id; returns the season product instead of the show.
1234567890
integer
Optional
Requested review result count per page.
10
string
Optional
Review pagination token from a previous response.
example
Request Examples
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrappa.co/api/apple/app-store/podcasts/product?product_id=1253186678&store=podcasts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: YOUR_API_KEY_HERE"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
<?php
use Illuminate\Support\Facades\Http;
$response = Http::timeout(30)
->withHeaders(['x-api-key' => 'YOUR_API_KEY_HERE'])
->get('https://scrappa.co/api/apple/app-store/podcasts/product?product_id=1253186678&store=podcasts');
if ($response->successful()) {
echo $response->body();
} else {
echo "Error: " . $response->status();
}
const options = {
method: 'GET',
headers: {
'x-api-key': 'YOUR_API_KEY_HERE'
}
};
fetch('https://scrappa.co/api/apple/app-store/podcasts/product?product_id=1253186678&store=podcasts', options)
.then(response => {
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
return response.text();
})
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
const axios = require('axios');
const options = {
method: 'GET',
url: 'https://scrappa.co/api/apple/app-store/podcasts/product?product_id=1253186678&store=podcasts',
headers: {
x-api-key: 'YOUR_API_KEY_HERE',
}
};
try {
const response = await axios(options);
console.log(response.data);
} catch (error) {
console.error('Error:', error.message);
}
require 'net/http'
require 'uri'
uri = URI.parse("https://scrappa.co/api/apple/app-store/podcasts/product?product_id=1253186678&store=podcasts")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'
request = Net::HTTP::Get.new(uri.request_uri)
request['x-api-key'] = 'YOUR_API_KEY_HERE'
begin
response = http.request(request)
puts response.body
rescue => e
puts "Error: #{e.message}"
end
import http.client
import json
conn = http.client.HTTPSConnection("scrappa.co")
headers = {
'x-api-key': 'YOUR_API_KEY_HERE',
}
try:
conn.request("GET", "/api/apple/app-store/podcasts/product?product_id=1253186678&store=podcasts", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
except Exception as e:
print(f"Error: {e}")
finally:
conn.close()
import requests
headers = {
'x-api-key': 'YOUR_API_KEY_HERE',
}
try:
response = requests.get('https://scrappa.co/api/apple/app-store/podcasts/product?product_id=1253186678&store=podcasts', headers=headers)
response.raise_for_status()
print(response.text)
except requests.exceptions.RequestException as e:
print(f"Error: {e}")
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import java.io.IOException;
public class ApiExample {
public static void main(String[] args) {
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://scrappa.co/api/apple/app-store/podcasts/product?product_id=1253186678&store=podcasts")
.addHeader("x-api-key", "YOUR_API_KEY_HERE")
.build();
try (Response response = client.newCall(request).execute()) {
if (response.isSuccessful()) {
System.out.println(response.body().string());
} else {
System.out.println("Error: " + response.code());
}
} catch (IOException e) {
System.out.println("Error: " + e.getMessage());
}
}
}
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
client := &http.Client{}
req, err := http.NewRequest("GET", "https://scrappa.co/api/apple/app-store/podcasts/product?product_id=1253186678&store=podcasts", nil)
if err != nil {
fmt.Println("Error creating request:", err)
return
}
req.Header.Set("x-api-key", "YOUR_API_KEY_HERE")
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error making request:", err)
return
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
fmt.Println("Error reading response:", err)
return
}
fmt.Println(string(body))
}
#!/bin/bash
curl -X GET \
-H "x-api-key: YOUR_API_KEY_HERE" \
"https://scrappa.co/api/apple/app-store/podcasts/product?product_id=1253186678&store=podcasts"
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY_HERE");
try
{
var response = await client.SendAsync(new HttpRequestMessage(HttpMethod.Get, "https://scrappa.co/api/apple/app-store/podcasts/product?product_id=1253186678&store=podcasts"));
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
}
catch (Exception ex)
{
Console.WriteLine($"Error: {ex.Message}");
}
}
}
import axios from 'axios';
async function run(): Promise<void> {
try {
const response = await axios({
method: 'GET',
url: 'https://scrappa.co/api/apple/app-store/podcasts/product?product_id=1253186678&store=podcasts',
headers: {
'x-api-key': 'YOUR_API_KEY_HERE',
},
});
console.log(response.data);
} catch (error) {
console.error('Error:', error);
}
}
void run();
use reqwest::Client;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = Client::new();
let response = client
.get("https://scrappa.co/api/apple/app-store/podcasts/product?product_id=1253186678&store=podcasts")
.header("x-api-key", "YOUR_API_KEY_HERE")
.send()
.await?;
println!("{}", response.text().await?);
Ok(())
}
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
search_parameters
product
ratings
reviews
reviews_pagination
Common reviews fields
id
title
author
rating
{
"search_parameters": {
"engine": "apple_app_store_details",
"product_id": "284882215",
"store": "apps",
"country": "us"
},
"product": {
"id": "284882215",
"store": "apps",
"title": "Facebook",
"artist": "Meta Platforms, Inc.",
"rating": 2.3,
"rating_count": 1300000,
"content_rating": "12+"
},
"ratings": {
"rating_average": 2.3,
"rating_count": 1300000,
"histogram": {
"1": 500000,
"2": 100000,
"3": 150000,
"4": 200000,
"5": 350000
}
},
"reviews": [
{
"id": "10086435917",
"title": "Great app",
"author": "reviewer",
"rating": 5,
"text": "Works well.",
"date": "2026-06-01T00:00:00Z",
"is_edited": false
}
],
"reviews_pagination": {
"offset": 0,
"limit": 20,
"next_offset": 20,
"next_page_token": "20",
"end_of_history": false
}
}
Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
The product_id or another parameter failed validation.
Apple Product Not Found
The product is legitimately absent in the requested storefront.
{
"error": "Apple App Store product not found.",
"error_code": "apple_app_store_not_found",
"retryable": false
}
Apple Upstream Unavailable
Apple could not be fetched through the configured proxy tiers after the full attempt budget.
{
"error": "Apple App Store upstream is temporarily unavailable.",
"error_code": "apple_app_store_upstream_unavailable",
"retryable": true
}
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.