Returns traffic and engagement metrics for a predefined segment of a website, including visits, traffic share, unique visitors, bounce rate, and more — across both desktop and mobile traffic. Historical data goes back 37 months, depending on your subscription.
Premium Endpoint
This endpoint is available to customers with access to the Segment Analysis feature in their subscription. Reach out to your Account Manager for more information.
How to find your Segment ID
- Use one of the 'List Segments' endpoints OR
- Visit an existing segment on the Similarweb platform, and extract the ID from the URL.
Device | Granularity | Metrics |
---|---|---|
all traffic | monthly, weekly, daily, last 28 days (daily, weekly) | visits, bounce-rate, pages-per-visit, visit-duration, page-views, traffic-share, unique-visitors |
all traffic | monthly | unique-visitors |
To retrieve 'Last 28 days' data, remove the start_date & end_date parameters and set granularity to "daily" or "weekly".
REST API Pricing
Data credits will be charged per metric requested, e.g - metrics=visits (1 data credits), metrics=visits, share (2 data credits) up to total of 7 metrics (7 data credits). Pulling this data is limited to 1 concurrent request.
For example:
Requesting 2 months, monthly granularity, 2 metrics - the price would be 4 data credits.When Using MTD flag it will charge additional credits.
REST API Limitations
- Only individual segments are supported.
Now also available via Batch API
You can now retrieve this data via our Batch API to streamline large-scale data access and reduce complexity.
Benefits
- Get bulk results in a single CSV file
- Automate delivery to: AWS S3, Google Cloud Storage, Snowflake
- Easily integrate into your data pipeline
- Schedule and track report generation
- Reduce the number of individual API calls
Limitations
- Supported granularities: daily, monthly
- Up to 100 segment IDs per request
Need help?
See our Batch API starter guide or check out the Batch API Reference to get started and discover more features.