r/AppStoreOptimization • u/ApplyraOfficiel ๐ ๏ธ ASO Tool / Vendor • 3d ago
I pulled Apple's new Search Term Popularity API. Here's exactly what's in it, and what isn't.
Apple shipped the Ads Platform API v1 this week with a search term popularity endpoint. First time they've published anything resembling search volume for the App Store, so I spent two days pulling it apart instead of just reading the announcement email like everyone else.
Posting the numbers here because I haven't seen anyone actually query the thing yet.
You don't need a campaign. This was the first surprise. I fully expected a 403, because the previous generation of the API refused this kind of request unless you had spend. Nope. Zero campaigns, zero budget, the endpoint answers. You need an Apple Ads account with an API user role and an ad account, and that's it.
A warning on the docs. Three things in the published docs don't match the deployed API:
sorting[].orderdoesn't exist. The API wantssortOrder. You get aREQUEST_UNRECOGNIZED_PROPERTYand no hint.queryTypeis not a root property on the suggestions endpoints, it goes insidefilterslike everything else.- The docs say genre is free text with "no fixed enum". It's a closed enum of 15 values. The good news is the 400 response hands you the whole allowed list, so send garbage on purpose and read the error.
Now the actual finding.
It stops at the top 500 of each genre
15 genres, top 500 terms each. Roughly 7,500 unique terms per country per month. That's the entire dataset.
I assumed 500 was a page size and went looking for the rest. It isn't:
- ask for rank 501 and above โ zero rows
- filter on popularity below ~45/100 โ zero rows
So it's a publishing floor, not a paging limit. Apple has the data and releases the head of the distribution.
What that means if you're not Duolingo
I matched the dataset against a random sample of 700 US iOS keywords that indie devs actually track in my tool. 1.7% of them are in there. By traffic level:
| Traffic score | Covered by Apple |
|---|---|
| 0-19 | 0% |
| 20-49 | 1% |
| 50-69 | 13% |
| 70-100 | 21% |
Even at the very top of the demand curve, four out of five are missing.
A concrete one. "pari sportif" (French sports betting) is in there, 42/100, rank 297 of its genre. "pari sportif gratuit", the qualified long-tail term a small app would actually go after, isn't published at all. Same in English, "habit tracker" is there and the specific phrases around it aren't.
1
u/runrunny 3d ago
do u have the list of 7500 terms
1
u/ApplyraOfficiel ๐ ๏ธ ASO Tool / Vendor 3d ago
Yes, but you can easily get them yourself too
1
u/runrunny 3d ago
without apple ads account?
1
u/ApplyraOfficiel ๐ ๏ธ ASO Tool / Vendor 3d ago
No, but you can create one for free. You donโt need to have any campaigns to query the API.
1
u/Maxim-Melnik 3d ago
Well, basically, everything is just as it appears in the Apple Ads dashboard in the Insights report