Similarweb API v5 (generated from docs.similarweb.com/api-v5 pages) / Returns a ranked list of top apps from the iOS App Store or Google Play.

Request parameters

• asc query · optional

  Orders the results by ascending or descending

• category_id query · required

  *category_id*: The category ID for the top chart. Example: "All"

• country query · required

  Two-letter country code (e.g., 'us', 'gb', 'ww'). Example: "us"

• date query · optional

  Date (format: YYYY-MM-DD). Default to the latest available top chart.

• device query · optional

  *device*: Options for apple store: iphone, ipad. For apple it defaults to: iphone, for google it defaults to: android. Example: "android"

• end_date query · optional

  End date in 'YYYY-MM' or 'YYYY-MM-DD' format or relative keywords: latest, X_months_ago, X_days_ago

• format query · optional

  Format in which the reply should be returned

• granularity query · optional

  Time granularity for the returned values

• limit query · optional

  Sets how many results to return.

• offset query · optional

  Defines the number of results to skip

• sort query · optional

  Selects a specific metric to order results by

• start_date query · optional

  Start date in 'YYYY-MM' or 'YYYY-MM-DD' format or relative keywords: latest, X_months_ago, X_days_ago

• store query · required

  Application store identifier

• type query · optional

  *type*: Type of the ranking list (top_free, top_paid, top_grossing)