TalorData Google Play SERP API for Python

TalorData SERP API helps you retrieve structured Google Play search data through a Python workflow for ASO analysis, app market research, competitor tracking, and app intelligence applications. This recipe shows how to extract app titles, developers, ratings, and ranking positions and integrate app search data into dashboards, AI agents, data pipelines, and automation workflows.

• TalorData Google Play SERP
  • Prerequisites
  • Installation
  • Getting the Google Play input
  • Running the SERP request
  • Notes
• TalorData Google Play SERP API
  • Request sample

TalorData Google Play SERP

Prerequisites

To run this tool, you need Python 3.11 or newer. The SERP tool uses TalorData SERP API, so you also need a TalorData SERP token.

Get your API key：Sign up at TalorData and get your API key from the dashboard.

Installation

Open a terminal window, navigate to this repository, and run:

make install

Or install with Poetry directly:

python -m pip install poetry==1.8.2

poetry install

Getting the Google Play input

This tool collects Google Play Search results through TalorData SERP API. It uses one engine only:

engine=google_play

Pass the search term with q:

q=Miga Town: My World

The local Google Play SERP preview looks like this:

The TalorData request parameters are summarized here:

Running the SERP request

Set your TalorData token first. Choose the command for your terminal.

On Windows Command Prompt:

set TALORDATA_SERP_API_TOKEN=<your_talordata_serp_token>

echo %TALORDATA_SERP_API_TOKEN%

On Windows PowerShell:

$env:TALORDATA_SERP_API_TOKEN="<your_talordata_serp_token>"

$env:TALORDATA_SERP_API_TOKEN

On macOS or Linux:

export TALORDATA_SERP_API_TOKEN=<your_talordata_serp_token>

echo "$TALORDATA_SERP_API_TOKEN"

To collect Google Play Search results for a keyword, run:

make serp QUERY=Miga Town: My World

With Poetry:

poetry run talordata-google-play-serp --query "Miga Town: My World" --output play_items.csv --format csv

To collect the same search as JSON instead:

poetry run talordata-google-play-serp --query "Miga Town: My World" --output play_items.json

To inspect the raw TalorData SERP response while exporting:

poetry run talordata-google-play-serp \
  --query "Miga Town: My World" \
  --output play_items.csv \
  --format csv \
  --debug-response raw-response.json

After running the command, the terminal output should look similar to this:

When the tool finishes, you should see a play_items.csv or play_items.json file in the directory where you ran it.

If you choose CSV, open play_items.csv in Excel, Google Sheets, or any text editor. It should have these columns:

title,link,author,rating,price,thumbnail,product_id
"Coffee App","https://play.google.com/store/apps/details?id=com.example.coffee","Example Studio",4.6,"$2.99","https://example.com/coffee-app.png","com.example.coffee"

A generated CSV preview looks like this:

Each row is one Google Play item. Use JSON when you want the full nested TalorData response; use CSV when you want a spreadsheet-friendly table.

Notes

This project does not fetch Google Play HTML directly. TalorData SERP API handles upstream fetching, request routing, parsing, and structured JSON output. This repository focuses on building the TalorData request, cleaning Google Play results, and exporting data for TalorData product workflows.

TalorData Google Play SERP API

TalorData Google Play SERP API returns structured Play Store search results such as titles, authors, ratings, product IDs, links, and thumbnails. It is designed for TalorData user workflows and public SERP topic pages.

Using the API consists of three main steps:

1. Create or retrieve your TalorData SERP API token in the dashboard.
2. Send a form-encoded request to the TalorData SERP endpoint.
3. Retrieve the data in structured JSON, then export it as JSON or CSV.

Request sample

In the example below, we request Google Play Search results for the search term Miga Town: My World.

The same API request is shown here as a quick visual reference:

import os
from pprint import pprint

import requests


payload = {
    "engine": "google_play",
    "q": "Miga Town: My World",
    "json": "2",
    "output_format": "json",
    "google_domain": "google.com",
    "gl": "us",
    "hl": "en",
}

response = requests.post(
    "https://serpapi.talordata.net/serp/v1/request",
    headers={
        "Authorization": f"Bearer {os.environ['TALORDATA_SERP_API_TOKEN']}",
        "Content-Type": "application/x-www-form-urlencoded",
    },
    data=payload,
    timeout=30,
)

response.raise_for_status()
pprint(response.json())

The CLI sends the same TalorData request contract:

Concern	TalorData SERP value
Search engine	engine=google_play
Structured response	json=2 and output_format=json
Authentication	Authorization: Bearer <TALORDATA_SERP_API_TOKEN>
Content type	application/x-www-form-urlencoded
Endpoint	https://serpapi.talordata.net/serp/v1/request

Supported Google Play parameters:

• q
• engine with the value google_play
• google_domain
• gl
• hl
• num
• start
• device
• no_cache

The output cleaner supports the local organic_results[].items[] response shape and TalorData envelope responses where JSON is nested inside data, result, response, or json.

Development

Run the CLI help:

poetry run talordata-google-play-serp --help

Learn more

Explore TalorData SERP API integrations and use cases:

Quick Start

View Documentation