Segment Traffic and Engagement - Total

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.
DeviceGranularityMetrics
all trafficmonthly,
weekly,
daily,
last 28 days (daily, weekly)
visits,
bounce-rate,
pages-per-visit,
visit-duration,
page-views,
traffic-share,
unique-visitors
all trafficmonthlyunique-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.

Language
Click Try It! to start a request and see the response here!