Contents

SearchTermPopularityQueryResponse

A response wrapper for search term popularity query results.

Declaration

object SearchTermPopularityQueryResponse

Properties

NameTypeDescription
resultSearchTermPopularityResultContainer

Container object holding the matching rows. Contains a rows array of SearchTermPopularityRow objects. See SearchTermPopularityResultContainer. Read-only.

paginationResponsePagination

Pagination metadata for the current result page, including offset, and pageSize. Read-only.

errorError

See Error for details. Read-only.

Discussion

Each row in result.rows always includes the following dimension fields:

Field

Description

countryOrRegion

The App Store country or region for the search volume data

genre

The App Store genre category

searchTerm

The search term text

week or month

The date field corresponding to the selected granularity

Rows include the following dimension fields only when requested via the request’s fields array.

Field

Description

rankInGenre

The search term’s rank by volume within the genre of the given App Store country or region.

searchPopularityInGenre

Relative popularity score within the genre (1–100) of the given App Store country or region.

searchPopularity1to100

Popularity score on a 1–100 scale across all genres within the country or region with 100 = most popular overall

searchPopularity1to5

Relative popularity on a 1–5 scale across all genres of the given App Store country or region.

See SearchTermPopularityRow for field descriptions.

Example

{
  "result": {
    "rows": [
      {
        "week": "2025-01-05",
        "countryOrRegion": "US",
        "genre": "PRODUCTIVITY_UTILITIES",
        "searchTerm": "task manager",
        "rankInGenre": 1,
        "searchPopularityInGenre": 95,
        "searchPopularity1to100": 88,
        "searchPopularity1to5": 5
      }
    ]
  },
  "pagination": {
    "offset": 0,
    "pageSize": 20
  }
}

See Also