> ## Documentation Index
> Fetch the complete documentation index at: https://socialquery.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Play app details

> One canonical Google Play App with description, public developer contact/website, ratings, prices, source-reported install counts, screenshots, related apps and update metadata when supplied. Missing fields remain null. Country accepts one of 211 source country codes, full names or numeric location codes; language accepts 127 source codes. Nonempty fresh responses cost five credits. Empty search, failures, cache and replay cost zero. New tasks share a finite persistent trial allowance; pending tasks are reused on retry for one hour. Only US/GB English were live-tested.

Pass a package name such as `com.spotify.music` as `app_id`. The response `data` is one canonical App record. It includes description, public developer email/address/website, price, rating, install display/count, screenshot/player URLs, genres, chart tags and related apps where available. Dates normalize to UTC. An absent app is an uncharged 404.

Missing version, size or other fields stay null. Install counts come from the provider and are not independently verified. Video URLs identify source players; they are not guaranteed downloadable files. Apple-only language/advisory fields are null. URLs and returned package IDs must agree with the requested app.

Country accepts one of 211 DataForSEO country locations by ISO code, country name or numeric location code (`US`, `United Kingdom`, `2840`). `UK` aliases `GB`. Language accepts one of 127 source locale codes and defaults to `en`. US and GB English are the live acceptance fixtures; other configured locales are not individually certified. Unsupported inputs fail before task submission.

Nonempty uncached responses cost **5 credits**. Empty search results, errors, cache and replay are free. Use `X-Max-Credits: 5` and allow a 60-second client timeout. A task that remains pending returns an uncharged `UPSTREAM_TASK_PENDING`; retrying the same parameters reuses durable task state for one hour instead of submitting another task.

<Note>The existing DataForSEO key and free balance are reused. New Google Play tasks share a non-resetting 140-unit verification ceiling: one unit per detail or per 30 requested search rows (at most seven for a search). Missing or exhausted budget state fails closed. No top-up or paid plan is enabled; sustained capacity remains unconfigured.</Note>


## OpenAPI

````yaml GET /google_play/app-info
openapi: 3.1.0
info:
  title: SocialQuery API
  version: '2026-10-09'
  description: >-
    Documented requests for public-source records. Inspect accepted inputs and
    credit amounts, then verify the selected operation before integrating
    preview coverage.
servers:
  - url: https://socialquery.dev/v1
security:
  - apiKey: []
paths:
  /google_play/app-info:
    get:
      tags:
        - Google Play
      summary: Google Play App Info
      description: >-
        One canonical Google Play App with description, public developer
        contact/website, ratings, prices, source-reported install counts,
        screenshots, related apps and update metadata when supplied. Missing
        fields remain null. Country accepts one of 211 source country codes,
        full names or numeric location codes; language accepts 127 source codes.
        Nonempty fresh responses cost five credits. Empty search, failures,
        cache and replay cost zero. New tasks share a finite persistent trial
        allowance; pending tasks are reused on retry for one hour. Only US/GB
        English were live-tested.
      operationId: get_google_play_app_info
      parameters:
        - name: app_id
          in: query
          required: true
          example: com.spotify.music
          schema:
            type: string
        - name: country
          in: query
          required: false
          example: United States
          schema:
            type: string
          description: >-
            One of 211 source countries by ISO code, full country name or
            numeric location code. UK aliases GB. Default US; only US and GB
            live-tested.
        - name: language
          in: query
          required: false
          schema:
            type: string
          description: >-
            One of 127 source language codes. Default en; only English
            live-tested.
        - name: Cache-Control
          in: header
          required: false
          example: no-cache
          schema:
            type: string
        - name: Idempotency-Key
          in: header
          required: false
          example: 7a5e1b4c-2d8f-4a3b-9c1e-6e8b4d2a1f3c
          schema:
            type: string
        - name: X-Max-Credits
          in: header
          required: false
          description: >-
            Optional nonnegative integer cap on the maximum request hold. A live
            request whose hold exceeds this cap returns 422
            CREDIT_BUDGET_EXCEEDED before spending. Metered holds use the
            requested limit; cache hits and successful idempotent replays cost
            zero.
          schema:
            type: integer
            minimum: 0
      responses:
        '200':
          description: >-
            One canonical Google Play App with description, public developer
            contact/website, ratings, prices, source-reported install counts,
            screenshots, related apps and update metadata when supplied. Missing
            fields remain null. Country accepts one of 211 source country codes,
            full names or numeric location codes; language accepts 127 source
            codes. Nonempty fresh responses cost five credits. Empty search,
            failures, cache and replay cost zero. New tasks share a finite
            persistent trial allowance; pending tasks are reused on retry for
            one hour. Only US/GB English were live-tested.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/SocialQueryResponse'
                  - type: object
                    properties:
                      data:
                        type: object
                        properties:
                          id:
                            type: string
                            description: >-
                              Store app ID (Google Play package name / App Store
                              numeric id)
                          store:
                            const: google_play
                          url:
                            type:
                              - string
                              - 'null'
                            description: String at app.url
                          title:
                            type:
                              - string
                              - 'null'
                            description: App title
                          subtitle:
                            type: 'null'
                          icon:
                            type:
                              - string
                              - 'null'
                            description: String at app.icon
                          description:
                            type:
                              - string
                              - 'null'
                            description: String at app.description
                          developer:
                            type: object
                            description: >-
                              Developer block (name, id, url; email/address for
                              Google)
                            properties:
                              id:
                                type:
                                  - string
                                  - 'null'
                                description: String at app.developer.id
                              name:
                                type:
                                  - string
                                  - 'null'
                                description: String at app.developer.name
                              url:
                                type:
                                  - string
                                  - 'null'
                                description: String at app.developer.url
                              email:
                                type:
                                  - string
                                  - 'null'
                                description: String at app.developer.email
                              address:
                                type:
                                  - string
                                  - 'null'
                                description: String at app.developer.address
                              website:
                                type:
                                  - string
                                  - 'null'
                                description: String at app.developer.website
                          rating:
                            type: object
                            description: Aggregate rating (value, max, number of ratings)
                            properties:
                              value:
                                type:
                                  - number
                                  - 'null'
                                minimum: 0
                                maximum: 5
                              max:
                                type:
                                  - number
                                  - 'null'
                                enum:
                                  - 5
                                  - null
                              count:
                                type:
                                  - integer
                                  - 'null'
                                minimum: 0
                          price:
                            type: object
                            description: >-
                              Price block (current, original, currency, is_free,
                              displayed)
                            properties:
                              current:
                                type:
                                  - number
                                  - 'null'
                                minimum: 0
                              original:
                                type:
                                  - number
                                  - 'null'
                                minimum: 0
                              currency:
                                type:
                                  - string
                                  - 'null'
                                description: String at app.price.currency
                              is_free:
                                type:
                                  - boolean
                                  - 'null'
                                description: Boolean at app.price.is_free
                              displayed:
                                type:
                                  - string
                                  - 'null'
                                description: String at app.price.displayed
                          reviews_count:
                            type:
                              - integer
                              - 'null'
                            description: Numeric at app.reviews_count
                          category:
                            type:
                              - string
                              - 'null'
                            description: String at app.category
                          categories:
                            type: 'null'
                          installs:
                            type:
                              - object
                              - 'null'
                            description: >-
                              Install signal (Google only): { display
                              "1,000,000,000+", count }; null on Apple
                            properties:
                              display:
                                type:
                                  - string
                                  - 'null'
                                description: String at app.installs.display
                              count:
                                type:
                                  - integer
                                  - 'null'
                                description: Numeric at app.installs.count
                          version:
                            type:
                              - string
                              - 'null'
                            description: String at app.version
                          minimum_os_version:
                            type:
                              - string
                              - 'null'
                            description: String at app.minimum_os_version
                          size:
                            type:
                              - string
                              - 'null'
                            description: String at app.size
                          released_at:
                            type:
                              - string
                              - 'null'
                          updated_at:
                            type:
                              - string
                              - 'null'
                          update_notes:
                            type:
                              - string
                              - 'null'
                            description: String at app.update_notes
                          image_urls:
                            type:
                              - array
                              - 'null'
                            description: Screenshot URLs
                            items:
                              type: string
                              description: Screenshot URLs
                          video_urls:
                            type:
                              - array
                              - 'null'
                            description: Array at app.video_urls
                            items:
                              type: string
                              description: String at app.video_urls
                          languages:
                            type: 'null'
                          advisories:
                            type: 'null'
                          genres:
                            type:
                              - array
                              - 'null'
                            description: Google Play genres (null on Apple)
                            items:
                              type: string
                              description: Google Play genres (null on Apple)
                          tags:
                            type:
                              - array
                              - 'null'
                            description: Array at app.tags
                            items:
                              type: string
                              description: String at app.tags
                          similar_apps:
                            type:
                              - array
                              - 'null'
                            description: Array at app.similar_apps
                            items:
                              type: object
                              description: 'Nested object: app.similar_apps'
                              properties:
                                id:
                                  type:
                                    - string
                                    - 'null'
                                  description: String at app.similar_apps.id
                                title:
                                  type:
                                    - string
                                    - 'null'
                                  description: String at app.similar_apps.title
                                url:
                                  type:
                                    - string
                                    - 'null'
                                  description: String at app.similar_apps.url
                          more_by_developer:
                            type:
                              - array
                              - 'null'
                            description: Array at app.more_by_developer
                            items:
                              type: object
                              description: 'Nested object: app.more_by_developer'
                              properties:
                                id:
                                  type:
                                    - string
                                    - 'null'
                                  description: String at app.more_by_developer.id
                                title:
                                  type:
                                    - string
                                    - 'null'
                                  description: String at app.more_by_developer.title
                                url:
                                  type:
                                    - string
                                    - 'null'
                                  description: String at app.more_by_developer.url
                          ext:
                            type: object
                            properties:
                              appdata:
                                type: object
                                properties:
                                  country:
                                    type: string
                                  requested_language:
                                    type: string
                                  source:
                                    const: dataforseo
                                  source_rank:
                                    type:
                                      - integer
                                      - 'null'
                                    minimum: 0
                                  coverage_note:
                                    type: string
                                required:
                                  - country
                                  - requested_language
                                  - source
                                  - source_rank
                                  - coverage_note
                                additionalProperties: false
                            required:
                              - appdata
                            additionalProperties: false
                        required:
                          - id
                          - store
                          - url
                          - title
                          - subtitle
                          - icon
                          - description
                          - developer
                          - rating
                          - price
                          - reviews_count
                          - category
                          - categories
                          - installs
                          - version
                          - minimum_os_version
                          - size
                          - released_at
                          - updated_at
                          - update_notes
                          - image_urls
                          - video_urls
                          - languages
                          - advisories
                          - genres
                          - tags
                          - similar_apps
                          - more_by_developer
                          - ext
                        additionalProperties: false
                    required:
                      - data
        '400':
          $ref: '#/components/responses/Error400'
        '401':
          $ref: '#/components/responses/Error401'
        '402':
          $ref: '#/components/responses/Error402'
        '403':
          $ref: '#/components/responses/Error403'
        '404':
          $ref: '#/components/responses/Error404'
        '405':
          $ref: '#/components/responses/Error405'
        '409':
          $ref: '#/components/responses/Error409'
        '422':
          $ref: '#/components/responses/Error422'
        '429':
          $ref: '#/components/responses/Error429'
        '500':
          $ref: '#/components/responses/Error500'
        '502':
          $ref: '#/components/responses/Error502'
        '503':
          $ref: '#/components/responses/Error503'
        '504':
          $ref: '#/components/responses/Error504'
components:
  schemas:
    SocialQueryResponse:
      type: object
      required:
        - success
        - platform
        - endpoint
        - credits_used
        - credits_remaining
        - request_id
        - cached
        - data
      properties:
        success:
          type: boolean
          const: true
        platform:
          type: string
        endpoint:
          type: string
        credits_used:
          type: integer
          minimum: 0
        credits_remaining:
          type:
            - integer
            - 'null'
        request_id:
          type: string
        cached:
          type: boolean
        data:
          type: object
          additionalProperties: true
          description: >-
            The selected operation determines the resource fields in this
            object. Source data can omit a metric or report it as null.
    SocialQueryError:
      type: object
      required:
        - success
        - platform
        - endpoint
        - credits_used
        - credits_remaining
        - request_id
        - cached
        - error
      properties:
        success:
          type: boolean
          const: false
        platform:
          type: string
        endpoint:
          type: string
        credits_used:
          type: integer
          minimum: 0
        credits_remaining:
          type:
            - integer
            - 'null'
        request_id:
          type: string
        cached:
          type: boolean
        error:
          type: object
          required:
            - code
            - type
            - message
            - status
            - doc_url
          properties:
            code:
              type: string
            type:
              type: string
            message:
              type: string
            status:
              type: integer
            doc_url:
              type: string
              format: uri
  responses:
    Error400:
      description: Upstream rejected the request.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error401:
      description: Missing, expired, invalid, or revoked API key.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error402:
      description: Insufficient SocialQuery credits.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error403:
      description: Key scope or provider policy denied access.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error404:
      description: Endpoint or upstream resource not found.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error405:
      description: HTTP method is not supported.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error409:
      description: Idempotency conflict or request in progress.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error422:
      description: Invalid parameters.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error429:
      description: Request limit reached.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error500:
      description: Request processing failed.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error502:
      description: Upstream service failed.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error503:
      description: Provider or required service is unavailable.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error504:
      description: Upstream service timed out.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.