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

Similarweb API V5 Documentation

Production

Sandbox

Ad Networks

AI Outreach

App Active Users

App Cross-Usage & Affinity

App Demographics

App Details

App Downloads

App IAB Categories

App Revenue

App Search

App Sessions

App Technographics (SDKs)

Contacts

Contacts Enrichment

Contacts Search

Lead Enrichment

Lead Enrichment - Company

Lead Enrichment - Website

Prompt Tracking

Keyword Competitors

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 the estimated Sessions Per User, Average Session Time Per Users and Total Sessions Time Per User for mobile apps across Google Play Store, Apple App Store, and both stores (“Unified”) over the given time frame.</p><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=info ><div class="callout-icon"><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p " >This endpoint uses 1 data credit per metric per result in the “data” array response. 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 the estimated Sessions Per User, Average Session Time Per Users and Total Sessions Time Per User for mobile apps across Google Play Store, Apple App Store, and both stores (“Unified”) over the given time frame.

This endpoint uses 1 data credit per metric per result in the “data” array response. Read the following 

api-key

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').

app_id

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

Comma separated list of metrics to retrieve. Available metrics: 'avg_sessions_count', 'avg_session_time', 'avg_sessions_total_time', 'total_sessions_count', 'total_sessions_time'. Defaults to a list including all of them.

Sections

App Sessions

Header Parameters

Query Parameters

Response

Response Attributes

What made this section unhelpful for you?

Response

What made this section unhelpful for you?

Sections

App Sessions

Header Parameters

Query Parameters

ResponseExpand all

Response Attributes

What made this section unhelpful for you?

Response

What made this section unhelpful for you?

Ask an AI

Code with AI

Response