google-play/
app-detail

The Google Play App Detail API retrieves public Google Play app details from known play.google.com URLs, returning identity, store text, developer, category, visible metrics, price, and media in normalized records.

Google Play App Detail API

Known app URLs
Batch detail lookup
Per-result billing
0.15 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Google Play App Detail

Google Play app details are public store listing records with application identity, descriptions, developer and category context, visible ratings and review counts, install ranges, price, and media. These fields support catalog enrichment, selected-app comparison, and point-in-time monitoring.

Google Play App Detail API Features

  • Known-URL batch boundarySend the Google Play App Detail API one or more play.google.com app URLs for direct detail lookup without turning the request into keyword discovery.
  • Listing identity and copyNormalize the package identifier, app name, public store description, developer, category, source URL, and collection time.
  • Visible market contextKeep available rating, review-count, install-range, price, and rank fields as nullable observations from the public listing.
  • Media-ready app recordsReturn media alongside a stable app schema so listing records can move through the same asynchronous results workflow as other SocQ data.

Google Play App Detail API Parameters

ParametersRequiredDescription
urlsRequiredRequired non-empty string array of known app URLs whose parsed hostname is play.google.com or a subdomain. Each accepted URL is one detail lookup.

How to Use the Google Play App Detail API

Submit known Google Play URLs to the Google Play App Detail API, track the asynchronous task, and read the normalized app records after completion.

  1. Prepare a non-empty urls array containing app links whose parsed hostname is play.google.com or a supported subdomain.
  2. POST the array to /v1/google-play/app-detail and save the returned task_id.
  3. Poll /v1/tasks/{task_id} until the task succeeds or fails.
  4. After success, read data.results.items. Follow next_cursor only when has_more is true; it pages records already stored by SocQ rather than discovering another Google Play source page.
curl -X POST "https://api.socq.ai/v1/google-play/app-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://play.google.com/store/apps/details?id=com.openai.chatgpt"]}'

# Poll GET /v1/tasks/{task_id}
# Read normalized app records from data.results.items

Google Play App Detail API Use Cases

  • Enrich a known app catalog: Turn stored Google Play links into normalized package IDs, titles, descriptions, developers, categories, source URLs, and collection timestamps.
  • Compare selected listings: Align available rating, review-count, install-range, price, category, and media fields across an approved set of app URLs.
  • Monitor listing snapshots: Repeat lookups on a defined schedule and compare nullable listing fields with collected_at to identify point-in-time changes.

Google Play App Detail API Pro Tips

  • Use full Google Play app URLs and deduplicate the array before submission so the estimate reflects intentional lookups.
  • Treat each input URL as eligible for at most one result, then align returned records by url or app_id because an accepted URL can still resolve to no item.
  • Store rating, review count, install range, price, rank, and media defensively because public listing fields can be absent or change after collection.
  • Use next_cursor only to continue reading a completed task's stored SocQ results; this detail endpoint does not expose Google Play search or source-page pagination.

Beyond the Google Play App Detail API, use these APIs when you need a different type of public Google Play data.

Explore other platforms

Combine Google Play data with public data from other supported social platforms.

Google Play App Detail API — FAQ

Google Play App Detail API is a programmatic interface for retrieving public store listing details from known Google Play app URLs. It returns normalized app identity, listing copy, developer, category, visible metrics, price, media, and collection context when available.

Submit a non-empty urls array. Every item must be a string whose parsed hostname is play.google.com or one of its subdomains.

No. It performs detail lookup for each known URL and can return at most one normalized record for that URL. An accepted URL is not a guarantee that a public item will resolve.

The app schema can contain ID, source URL, package ID, name, text, developer, category, rating, review count, install range, price, rank, media, and collection time. Public fields that are unavailable can be null.

The estimate uses the number of submitted URLs at 0.15 SocQ credits each. Final billing is 0.15 credits per returned result with a zero-credit base, so a successful task with no returned records has a final charge of zero credits.