Retrieve a Google Play TV show by product ID: title, release year, rating, star breakdown, poster, genres, seasons with prices and links, the episodes of the selected season (pass season_id from the seasons list to switch season) and reviews. Review filters and paging load pages from Google Play's review feed.
Run this endpoint
Endpoint
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.
12 optional filters available.
string
Required
Google Play product id. For apps this is the package name.
URvLYOHGqGs.P
string
Optional
Legacy alias for product_id.
1234567890
string
Optional
Google Play store vertical: apps, movies, tv, books, or audiobooks.
tv
string
Optional
TV season id for Google Play TV products.
1234567890
boolean
Optional
Load reviews from Google Play's review feed (up to num, default 40) instead of the sample embedded in the product page. Using any review filter below does the same.
true
string
Optional
Only reviews written on this device type: phone, tablet, watch, chromebook, tv or car. Mainly useful for apps.
example
integer
Optional
Only reviews with this star rating, from 1 to 5.
10
string
Optional
Review order: 1 or most_relevant (default), 2 or newest, 3 or rating.
example
integer
Optional
Number of reviews to return when review parameters are used, from 1 to 100 (default 40).
10
string
Optional
pagination.next_page_token from a previous response, to load the next page of reviews. Send the same filters again.
example
string
Optional
Google Play URL of the item. Alternative to supplying the product identifier.
https://example.com/product
string
Optional
Interface language code (e.g. en, de).
en
string
Optional
Country code for the storefront (2 letters, e.g. us, de).
us
Request Examples
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrappa.co/api/google/play/tv/product?product_id=URvLYOHGqGs.P&store=tv",
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/google/play/tv/product?product_id=URvLYOHGqGs.P&store=tv');
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/google/play/tv/product?product_id=URvLYOHGqGs.P&store=tv', 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/google/play/tv/product?product_id=URvLYOHGqGs.P&store=tv',
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/google/play/tv/product?product_id=URvLYOHGqGs.P&store=tv")
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/google/play/tv/product?product_id=URvLYOHGqGs.P&store=tv", 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/google/play/tv/product?product_id=URvLYOHGqGs.P&store=tv', 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/google/play/tv/product?product_id=URvLYOHGqGs.P&store=tv")
.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/google/play/tv/product?product_id=URvLYOHGqGs.P&store=tv", 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/google/play/tv/product?product_id=URvLYOHGqGs.P&store=tv"
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/google/play/tv/product?product_id=URvLYOHGqGs.P&store=tv"));
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/google/play/tv/product?product_id=URvLYOHGqGs.P&store=tv',
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/google/play/tv/product?product_id=URvLYOHGqGs.P&store=tv")
.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
app
product_info
about_this_show
categories
ratings
seasons
episodes
+2 more
Common categories fields
name
link
category_id
{
"search_parameters": {
"engine": "google_play_tv_product",
"product_id": "URvLYOHGqGs.P",
"id": "URvLYOHGqGs.P",
"store": "tv",
"hl": "en",
"gl": "US"
},
"app": {
"app_id": "URvLYOHGqGs.P",
"title": "Abbott Elementary",
"url": "https://play.google.com/store/tv/show?id=URvLYOHGqGs.P&hl=en&gl=US"
},
"product_info": {
"title": "Abbott Elementary",
"release_year": 2021,
"seasons": 5,
"rating": 4.8,
"reviews": 19,
"thumbnail": "https://play-lh.googleusercontent.com/o5D6dcuOq3OAKBI2B3cJ_NWKcFlCX4qyku3r02Cnhy_FH45HWTRUpOP-BCJrMtno0myNIRnHrk2dNAZXoQ",
"product_id": "URvLYOHGqGs.P",
"link": "https://play.google.com/store/tv/show?id=URvLYOHGqGs.P&hl=en&gl=US"
},
"about_this_show": {
"snippet": "In this workplace comedy from writer/executive producer/star Quinta Brunson (A Black Lady Sketch Show) and executive producers Justin Halpern & Patrick..."
},
"categories": [
{
"name": "Comedy",
"link": "https://play.google.com/store/movies/category/1004",
"category_id": "1004"
}
],
"ratings": [
{
"stars": 1,
"count": 1
},
{
"stars": 2,
"count": 0
},
{
"stars": 3,
"count": 0
},
{
"stars": 4,
"count": 0
},
{
"stars": 5,
"count": 18
}
],
"seasons": [
{
"season_id": "K0QcrFNejFM.P",
"season_number": 5,
"link": "https://play.google.com/store/tv/show?id=URvLYOHGqGs.P&cdid=tvseason-K0QcrFNejFM.P",
"offers": [
{
"text": "$19.99 Buy full season HD",
"price": "$19.99",
"extracted_price": 19.99,
"currency": "USD",
"link": "https://play.google.com?rdid=tvseason-K0QcrFNejFM.P&feature=md&offerId=990e4abd00000000"
}
]
},
{
"season_id": "Ohh1wwe-EdU.P",
"season_number": 4,
"title": "Season 4",
"link": "https://play.google.com/store/tv/show?id=URvLYOHGqGs.P&cdid=tvseason-Ohh1wwe-EdU.P",
"offers": [
{
"text": "$19.99 Buy full season HD",
"price": "$19.99",
"extracted_price": 19.99,
"currency": "USD",
"link": "https://play.google.com?rdid=tvseason-Ohh1wwe-EdU.P&feature=md&offerId=b662cb4d00000000"
}
]
}
],
"episodes": [
{
"episode_id": "pXhAl0PUNYc.P",
"episode_number": 1,
"title": "Team Building",
"snippet": "The teachers prepare for the upcoming school year with new faces and big changes on the horizon.",
"release_date": "2025-10-01",
"thumbnail": "https://play-lh.googleusercontent.com/pVFgDZ0zN0vSmTDqzdEGyDyhujUQVi3yy4wqbAk-xJJiuqFzgGIRV1DbTC04trQm95xmwTxFoSV8o_DAiFQ",
"offers": [
{
"text": "$2.99 Buy",
"price": "$2.99",
"extracted_price": 2.99,
"currency": "USD",
"link": "https://play.google.com?rdid=tvepisode-pXhAl0PUNYc.P&feature=md&offerId=99d3b96500000000"
}
]
}
],
"reviews": [
{
"id": "f6e38d2d-e3c5-463b-a26d-e0d12534bf27",
"title": "Christy Herndon",
"avatar": "https://play-lh.googleusercontent.com/a-/ALV-UjU4D5X2gApqTv9VtFBKvautfcrA01dv3woCSXDQBzS5aB9oRDgs",
"rating": 5,
"snippet": "As a teacher I can relate to things things they talk about and go through. This show is a great spin onthe misadventures of the education world and everyne who...",
"likes": 0,
"date": "October 27, 2022",
"iso_date": "2022-10-27T19:04:19Z"
}
],
"similar_results": []
}
Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
The id or url parameter failed validation.
Google Play Upstream Unavailable
The upstream service is temporarily unavailable. Please retry shortly.
{
"error": "Google Play upstream is temporarily unavailable.",
"error_code": "google_play_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.
Try It Live
Test this endpoint in our interactive playground with real data.