<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/SearchTermPopularityQueryResponse",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "data:apple-ads-platform-api:SearchTermPopularityQueryResponse"
  },
  "title" : "SearchTermPopularityQueryResponse"
}
-->

# SearchTermPopularityQueryResponse

A response wrapper for search term popularity query results.

```
object SearchTermPopularityQueryResponse
```

## 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`](/documentation/Apple-Ads-Platform-API/SearchTermPopularityRow) for field descriptions.

### Example

```json
{
  "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
  }
}
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)