---
title: SearchTermPopularityRow
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/searchtermpopularityrow
---

# SearchTermPopularityRow

A single search term popularity data row.

## Declaration

```data
object SearchTermPopularityRow
```

## Properties

week: The date immediately following the completed weekly range, in YYYY-MM-DD format. For example, a range covering Sunday through Saturday returns the following Sunday’s date. Present when granularity is WEEKLY_SUN_SAT. Read-only. month: Calendar month of the report snapshot in YYYY-MM format. Present when granularity is MONTHLY. Read-only. countryOrRegion: ISO 3166-1 alpha-2 country or region code. Data is available for approximately 90 countries and regions, excluding Russia and Belarus. Always included in the response. Read-only. genre: App Store genre classification. Always included in the response. Read-only. searchTerm: The search term. Only terms meeting eligibility criteria (≥ 500 searches and ≥ 10 impressions within the reporting period) are included. Always included in the response. Read-only. rankInGenre: Rank of the search term by search volume within its country or region and genre. Rank 1 = highest volume. Up to 500 search terms per country and genre combination. Included only when requested via the request’s fields array. Read-only. searchPopularityInGenre: Popularity within country or region and genre on a 1–100 scale. 100 = most popular within that genre. Included only when requested via the request’s fields array. Read-only. searchPopularity1to100: Popularity score on a 1–100 scale across all genres within the country or region. 100 = most popular overall. Use to compare a term’s in-genre popularity against its market-wide popularity. Include only when requested via the request’s fields array. Read-only. searchPopularity1to5: Popularity across all genres within country/region on a 1–5 scale. 5 = most popular. Matches the Search Popularity metric displayed in Campaign Management. Include only when requested via the request’s fields array. Read-only.

## Discussion

Discussion Each SearchTermPopularityRow represents one combination of time period, country or region, genre, and search term in a search term popularity report. The date field present depends on the granularity in SearchTermPopularityTimeRange: week for WEEKLY_SUN_SAT, month for MONTHLY. Popularity metrics The response provides three popularity scales, each scoped differently. Example {   "week": "2025-01-05",   "countryOrRegion": "US",   "genre": "GAMES",   "searchTerm": "awayfinder",   "rankInGenre": 42,   "searchPopularityInGenre": 78,   "searchPopularity1to100": 65,   "searchPopularity1to5": 4 }

## See Also

- [ImpressionShareQueryRequest](apple-ads-platform-api/impressionsharequeryrequest.md)
- [ImpressionShareQueryResponse](apple-ads-platform-api/impressionsharequeryresponse.md)
- [ImpressionShareRow](apple-ads-platform-api/impressionsharerow.md)
- [ImpressionShareTimeRange](apple-ads-platform-api/impressionsharetimerange.md)
- [ImpressionShareOptions](apple-ads-platform-api/impressionshareoptions.md)
- [SearchTermPopularityQueryRequest](apple-ads-platform-api/searchtermpopularityqueryrequest.md)
- [SearchTermPopularityQueryResponse](apple-ads-platform-api/searchtermpopularityqueryresponse.md)
- [SearchTermPopularityTimeRange](apple-ads-platform-api/searchtermpopularitytimerange.md)
- [ImpressionShareResultContainer](apple-ads-platform-api/impressionshareresultcontainer.md)
- [SearchTermPopularityResultContainer](apple-ads-platform-api/searchtermpopularityresultcontainer.md)
- [KeywordInsights](apple-ads-platform-api/keywordinsights.md)
- [ReportingKeywordBidRecommendation](apple-ads-platform-api/reportingkeywordbidrecommendation.md)