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

# SearchTermPopularityRow

A single search term popularity data row.

```
object SearchTermPopularityRow
```

## 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`](/documentation/Apple-Ads-Platform-API/SearchTermPopularityTimeRange): `week` for `WEEKLY_SUN_SAT`, `month` for `MONTHLY`.

### Popularity metrics

The response provides three popularity scales, each scoped differently.

### Example

```json
{
  "week": "2025-01-05",
  "countryOrRegion": "US",
  "genre": "GAMES",
  "searchTerm": "awayfinder",
  "rankInGenre": 42,
  "searchPopularityInGenre": 78,
  "searchPopularity1to100": 65,
  "searchPopularity1to5": 4
}
```

---

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)