# Google Play TV Product

Google Play TV product endpoint with SerpApi-compatible product_id, season_id, localization, review filter, and pagination parameters.

- **Documentation:** [https://scrappa.co/docs/google-play-api/google_play_tv_product](https://scrappa.co/docs/google-play-api/google_play_tv_product)
- **API group:** Google Play API
- **Endpoint:** `GET https://scrappa.co/api/google/play/tv/product`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `product_id` | string | Yes | Google Play product id. For apps this is the package name. |
| `id` | string | No | Legacy alias for product_id. |
| `store` | string | No | Google Play store vertical: apps, movies, tv, books, or audiobooks. |
| `season_id` | string | No | TV season id for Google Play TV products. |
| `all_reviews` | boolean | No | Request Google Play review-expanded product pages when available. |
| `platform` | string | No | Review platform filter, such as phone, tablet, tv, chromebook, watch, or car. |
| `rating` | integer | No | Review rating filter from 1 to 5. |
| `sort_by` | string | No | Review sort mode, such as 1, 2, 3, most_relevant, newest, or rating. |
| `num` | integer | No | Requested review result count for clients that need SerpApi-compatible parameters. |
| `next_page_token` | string | No | Review pagination token for clients that need SerpApi-compatible parameters. |
| `url` | string | No | Google Play URL of the item. Alternative to supplying the product identifier. |
| `hl` | string | No | Interface language code (e.g. en, de). |
| `gl` | string | No | Country code for the storefront (2 letters, e.g. us, de). |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/google/play/tv/product?product_id=com.hair_flutter&store=apps"
```

## Example response

```json
{
    "search_parameters": {
        "engine": "google_play_details",
        "product_id": "com.hair_flutter",
        "id": "com.hair_flutter",
        "store": "apps",
        "hl": "en",
        "gl": "US"
    },
    "app": {
        "app_id": "com.hair_flutter",
        "title": "Hairstyle Try On - AI Haircut",
        "developer": "JYCoder",
        "url": "https://play.google.com/store/apps/details?id=com.hair_flutter&hl=en&gl=US"
    },
    "product_info": {
        "title": "Hairstyle Try On - AI Haircut",
        "authors": [
            {
                "name": "JYCoder",
                "link": "https://play.google.com/store/apps/developer?id=JYCoder"
            }
        ],
        "extensions": [
            "Contains ads",
            "In-app purchases"
        ],
        "rating": 3.9,
        "reviews": 130971,
        "downloads": "1M+",
        "thumbnail": "https://play-lh.googleusercontent.com/9h_tFkTEDjJ_xJm_Q3esLk2UKJxI4pZNHHbUg1JBJOyfJWb7Fh4isLlc8KeC5BmBYUGBlnvOnFEhcqJBWQik"
    },
    "media": {
        "images": [
            "https://play-lh.googleusercontent.com/3W68JpIQJRZbIitj6YHlfOSCrGW0w2aoF0rd041n4gA7BL31yStxbEZCgBzW706fhW_4XfC51cbW0_QOErlcKMo=w526-h296-rw"
        ]
    },
    "about_this_app": {
        "version": "338.0.0",
        "requires_android": "6.0",
        "in_app_purchases": "$9.99 - $49.00 per item",
        "released_on": "Jun 2, 2021",
        "updated_on": "Jun 25, 2026",
        "downloads": "1,000,000+",
        "content_rating": "Everyone",
        "offered_by": "JYCoder"
    },
    "categories": [
        {
            "name": "Beauty",
            "link": "https://play.google.com/store/apps/category/BEAUTY",
            "category_id": "BEAUTY"
        }
    ],
    "data_safety": [
        {
            "text": "No data collected",
            "subtext": "Learn more about how developers declare collection"
        },
        {
            "text": "Data is encrypted in transit"
        }
    ],
    "ratings": [
        {
            "stars": 5,
            "count": 88416
        }
    ],
    "reviews": [
        {
            "id": "57bfa1c4-d7ec-4c10-b6b4-5c01c888804f",
            "title": "Amanda Christian",
            "rating": 1,
            "snippet": "Summary - definitely not worth the 50 for subscription...",
            "likes": 5,
            "date": "June 13, 2026",
            "iso_date": "2026-06-13T00:07:15Z"
        }
    ],
    "app_support": {
        "support_email": "jycoder@gmail.com",
        "privacy_policy": "https://doc-hosting.flycricket.io/hairstyle-try-on-privacy-policy/75714506-5e43-441d-8d62-852687598dd2/privacy"
    },
    "about_the_developer": {
        "name": "\u5b63\u5b87\u7eaf",
        "email": "myt890515@gmail.com",
        "address": "\u5357\u516d\u516c\u8def399\u5f04 \u6d66\u4e1c\u65b0\u533a, \u4e0a\u6d77\u5e02 China 201399"
    },
    "developer_contact": {
        "website": "https://z91650577.app-ads-txt.com",
        "support_email": "jycoder@gmail.com",
        "privacy_policy": "https://doc-hosting.flycricket.io/hairstyle-try-on-privacy-policy/75714506-5e43-441d-8d62-852687598dd2/privacy",
        "name": "\u5b63\u5b87\u7eaf",
        "alternative_email": "myt890515@gmail.com",
        "address": "\u5357\u516d\u516c\u8def399\u5f04 \u6d66\u4e1c\u65b0\u533a, \u4e0a\u6d77\u5e02 China 201399"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The id or url parameter failed validation. |
| 503 | Google Play Upstream Unavailable | Google Play could not be fetched through the configured server-status cookie session and curl_cffi sidecar path. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)