Similarweb

Getting Started

Introduction

What's New in V5

Authentication

Making Your First Request

Guides

Available Data

Popular Use Cases

REST API vs Batch API

API Pricing & Data Credits

Error Handling & Troubleshooting

API Reference

<p class="slate-p " >Endpoints returning traffic and engagement statistics.</p><p class="slate-p " ></p><p class="slate-p " ></p>

Web Intelligence API

Search Intelligence API

Sales Intelligence API

App Intelligence API

Gen AI Intelligence API

Similarweb MCP

MCP Integrations

Support and FAQ

Country Codes

Check Capabilities

Default

API V5 latest - USE THIS

Similarweb API V5 Documentation

Production

Sandbox

Ad Networks

AI Outreach

App Active Users (DAU/WAU/MAU)

App Cross-Usage & Affinity

App Demographics

App Details

App Downloads

App IAB Categories

App Ranks

App Revenue

App Search

App Sessions

App Technographics (SDKs)

App Top Charts

Contacts

Contacts Enrichment - Single

Contacts Enrichment - Bulk

Contacts Search

Lead Enrichment

Lead Enrichment - Company

Lead Enrichment - Website

Prompt Tracking

Keyword Competitors

Keywords Overview

Landing Pages

SERP Players - Aggregated

SERP Players - Clicks over time

Website Keywords

Website Audience

Audience Interest

Audience Overlap

Deduplicated Audience

Demographics

Demographics - specific groups

Website Content

Popular pages

Website Folders

Website Subdomains

Website Technologies

Website Performance

Marketing Channel Sources

PPC Spend

Referrals

Top Sites Ranking

Traffic & Engagement

Traffic Geography

Website Ranking

Website Segments

List predefined segments

List User Segments

Segments Analysis

Segments Marketing Channels

Check Data Credits Balance

Claude Integration

Cursor Integration

Manus Integration

Microsoft Copilot Integration

**Constraints:**

- *search_in* supports app_id, app_title, publisher_name and description

**Input Parameters:**

- *store*: Application store identifier — 'google', 'apple' or 'unified'
- *term*: The term to search in the app stores
- *search_in*: The fields to search the term in for the apps
- *limit*: number of app result to return, default and max is 100

**Output Data:**

- *app_id*: Unique application identifier. Google app IDs consist of letters, numbers, and dots (e.g., 'com.facebook.katana'), Apple app IDs are numeric only (e.g., '447188370') and unified app IDs are a unique string identified (e.g., '487h3erjk23iueiu2yuy32h234yiuy3h3')
- *store*: Application store identifier — 'google', 'apple' or 'unified'
- *title*: Display name of the app
- *publisher_name*: Name of the app publisher
- *icon_small_url*: URL to the app’s icon (small size)

**Constraints:**

- *app_id* is required and cannot be empty
- *country* must be a valid two-letter country code
- *language* must be a supported language code

**Input Parameters:**

- *store* : The respective store to be queried for the app ID ('google' or 'apple')
- *app_id* : Google: string only for app ID. Apple: int for app ID or string for Bundle ID
- *country* : ID of supported countries (e.g. US,FR,UK)
- *language* : Language for content fields (e.g. en, de, fr, etc.)
- *include_unpublished_apps* : Flag whether to return unpublished apps
- *format*: Format in which the reply should be returned. Possible values: 'json' (default) or 'xml'

**Output Data:**

- *app_store*: App store (e.g., 'apple', 'google')
- *app_id*: Unique application identifier. Google app IDs consist of letters, numbers, and dots (e.g., 'com.facebook.katana'), while Apple app IDs are numeric only (e.g., '447188370').
- *is_published*: Indicated if the app is published or not
- *app_title*: Display name of the app
- *bundle_id*: iOS bundle ID (iOS only)
- *publisher_name*: Name of the app publisher
- *publisher_apps*: Other apps from the publsiher. List of package names for Android, List of Longs for iOS
- *video_urls*: Link to promotional app video on Youtube
- *app_website*: The app’s website address as shown on the respective App Store
- *category_primary_id*: Primary app category id
- *category_primary_name*: Primary app category name
- *category_secondary_ids*: Secondary app categories ids
- *category_secondary_names*: Secondary app categories names
- *store_url*: Link to the app’s page on App Store / Play Store
- *icon_small_url*: URL to the app’s icon (small size)
- *icon_large_url*: URL to the app’s icon (high-res)
- *screenshot_urls*: List of screenshot URLs
- *featured_graphic_url*: URL to the app’s featured graphic (Android only)
- *description*: Full description of the app in the App Store. 
- *short_description*: Short summary (usually 80-100 chars)
- *localized_languages*: Languages in which the app is translated, according to the app developer
- *contains_ads*: A boolean flag that signifies whether an app contains ads or not, as listed on its app page
- *price*: “Free” / “Paid”
- *price_value*: By the country's currency, the (free apps/ no country provided  shall be shown as “null”)
- *price_currency*: ISO 4217 currency code(free apps/ no country provided  shall be shown as “null”)
- *app_availability*: Country codes for which countries the app is available. Not applied on unpublished apps
- *app_size*: App size (in bytes, optional, if app has multiple versions)
- *in_app_purchases*: Indicates if the app supports IAPs
- *release_date*: Initial store release date (yyyy-mm-dd)
- *last_update_date*: Most recent update date
(yyyy-mm-dd)

- *version*: Current store version
- *privacy_policy_url*: Link to privacy policy page
- *ratings_count*: Total number of app ratings (per country for iOS and global for Android, null for no data)
- *average_rating*: App rating (from 1 to 5, 5 being the highest) shall be applied per country. null in case of no data or if never rated. 

<p class="slate-p " >Returns a ranked list of top apps from the iOS App Store or Google Play.</p><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=success ><div class="callout-icon"><svg width="18" height="18" viewBox="0 0 18 18" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M7.77116 10.8968L5.72949 8.8551C5.60449 8.7301 5.45171 8.6676 5.27116 8.6676C5.0906 8.6676 4.93088 8.73705 4.79199 8.87594C4.6531 9.01482 4.58366 9.17455 4.58366 9.3551C4.58366 9.53566 4.6531 9.68844 4.79199 9.81344L7.33366 12.3551C7.45866 12.4801 7.60449 12.5426 7.77116 12.5426C7.93783 12.5426 8.08366 12.4801 8.20866 12.3551L13.2087 7.3551C13.3337 7.2301 13.3927 7.07732 13.3857 6.89677C13.3788 6.71621 13.3128 6.56344 13.1878 6.43844C13.0628 6.29955 12.9066 6.2301 12.7191 6.2301C12.5316 6.2301 12.3684 6.29955 12.2295 6.43844L7.77116 10.8968ZM9.00033 17.3343C7.81977 17.3343 6.72255 17.1225 5.70866 16.6989C4.69477 16.2752 3.81283 15.6884 3.06283 14.9384C2.31283 14.1884 1.72602 13.3065 1.30241 12.2926C0.878798 11.2787 0.666992 10.1815 0.666992 9.00094C0.666992 7.83427 0.878798 6.74399 1.30241 5.7301C1.72602 4.71621 2.31283 3.83427 3.06283 3.08427C3.81283 2.33427 4.69477 1.74399 5.70866 1.31344C6.72255 0.88288 7.81977 0.667603 9.00033 0.667603C10.167 0.667603 11.2573 0.88288 12.2712 1.31344C13.285 1.74399 14.167 2.33427 14.917 3.08427C15.667 3.83427 16.2573 4.71621 16.6878 5.7301C17.1184 6.74399 17.3337 7.83427 17.3337 9.00094C17.3337 10.1815 17.1184 11.2787 16.6878 12.2926C16.2573 13.3065 15.667 14.1884 14.917 14.9384C14.167 15.6884 13.285 16.2752 12.2712 16.6989C11.2573 17.1225 10.167 17.3343 9.00033 17.3343ZM9.00033 16.0843C11.0142 16.0843 12.6982 15.4072 14.0524 14.053C15.4066 12.6989 16.0837 11.0148 16.0837 9.00094C16.0837 6.98705 15.4066 5.30302 14.0524 3.94885C12.6982 2.59469 11.0142 1.9176 9.00033 1.9176C6.98644 1.9176 5.30241 2.59469 3.94824 3.94885C2.59408 5.30302 1.91699 6.98705 1.91699 9.00094C1.91699 11.0148 2.59408 12.6989 3.94824 14.053C5.30241 15.4072 6.98644 16.0843 9.00033 16.0843Z" fill="#06837A"></path></svg></div><div ><p class="slate-p " >This endpoint uses 1 data credits per result in the “data” array response. Example: 10 apps ranked on a top chart = 10 credits.
Read the following <a href="68b5f6f7d688be390d72048c/68b36d640ffb10e152353cfa" target="_blank">guide</a> to estimate the credit costs. </p></div></div><p class="slate-p " ></p>

Returns a ranked list of top apps from the iOS App Store or Google Play.

This endpoint uses 1 data credits per result in the “data” array response. Example: 10 apps ranked on a top chart = 10 credits.
Read the following 

api-key

granularity

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

country

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

start_date

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

end_date

store

*category_id*: The category ID for the top chart.

category_id

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

type

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

Sections

App Top Charts

Header Parameters

Query Parameters

Response

Response Attributes

Response

Sections

App Top Charts

Header Parameters

Query Parameters

ResponseExpand all

Response Attributes

Response

Ask an AI

Code with AI

Response