Data

Return a keyword popularity score

Returns a 1–100 popularity score from the best available signal. When Apple censors a low direct value, an exact normalized term appearing before the full iPhone autocomplete query can conservatively raise the result to 6–10; it never lowers a stronger score or exceeds 10. Prefix and derived evidence are cached for 30 days independently from the eight-hour base popularity cache. A long cold prefix curve may finish in the background and affect a later request. A successful response costs one credit.

post/v1/popularity

Request

  • Base URL: https://api.asoskill.com
  • URL: https://api.asoskill.com/v1/popularity
  • Auth: HTTP bearer

Request body

termstring required
storefrontstring

Two-letter App Store storefront code; normalized to uppercase

Response

Popularity result; costs one credit

termstring required
storefrontstring required
scoreinteger required
source'monthly' | 'direct' | 'related' | 'autocomplete' | 'fallback' required

Autocomplete means a conservative low-volume estimate based on the exact term appearing before the full query; raw prefixes and censored Apple values are not exposed.

resolution'final' | 'pending' required

Pending means background autocomplete evidence is still being collected and the score may improve on a later request. Cache only final results with the normal freshness policy.

scoreVersioninteger required

Version of the popularity resolution model used for this response.

retryAfterSecondsinteger

Suggested delay before checking a pending result again.

cache'hit' | 'refresh' | 'stale' required
fetchedAtstring date-time required
requestIdstring required

Changes

No recorded changes to this operation across all 1 revision of this API.