Guides
Go to SimilarwebContact us

Websites Audience & Demographics Dataset

Analyze the overlapping audiences across multiple websites and gain valuable insights into the demographics and interests of visitors to your website, your competitors' websites, and your industry.

Suggest Edits

📊

Historical Data Availability

Access up to 37 months of historical data, depending on your subscription plan.

What You Can Track

  • Demographics: Provides demographic breakdown of website visitors by age and gender, including engagement metrics for each demographic segment.
  • Audience Interests: Identifies websites frequently visited by the same audience and measures the overlap and affinity between different domains' visitors.

📘

Batch API and REST API have different Keys

Make sure you're using the correct API Key with the query

Getting Started

1. Authentication

Include your Batch API key in the request headers:

curl --location 'https://api.similarweb.com/batch/v4/request-report' \
--header 'api-key: {{API_KEY}}' \
--header 'Content-Type: application/json' \
--request POST \
--data body

2. Request Structure

All Websites Dataset requests follow this structure:

🦉
Batch API Request - Step-by-Step Walkthrough
Open Recipe

Available Tables (vtables)

Demographics (demographics)

Primary use case: Provides demographic breakdown of website visitors by age and gender, including engagement metrics for each demographic segment.

Primary Keys: domains, countries

Available Metrics:

Metric NameDescriptionSupported Granularity
demographics_shareTotal traffic share for a given domain and demographics criteria (age+gender)Monthly
demographics_avg_visit_durationAverage visit duration (in seconds) for a given domain and demographics criteriaMonthly
demographics_bounce_rateBounce rate for a given domain and demographics criteriaMonthly
demographics_pages_per_visitPages per visit for a given domain and demographics criteriaMonthly

Example Request

curl --location 'https://api.similarweb.com/batch/v4/request-report' \
--header 'api-key: {{API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
  "delivery_information": {
    "response_format": "csv",
    "delivery_method_params": {
      "retention_days": 60
    }
  },
  "report_query": {
    "tables": [
      {
        "vtable": "demographics",
        "granularity": "monthly",
        "filters": {
          "domains": [
            "similarweb.com",
            "google.com"
          ],
          "countries": [
            "WW",
            "US"
          ],
          "age_groups": [
            "18-24",
            "25-34",
            "35-44",
            "45-54",
            "55-64",
            "65+"
          ],
          "gender": [
            "male",
            "female"
          ]
        },
        "metrics": [
          "demographics_avg_visit_duration",
          "demographics_bounce_rate",
          "demographics_pages_per_visit",
          "demographics_share"
        ],
        "start_date": "2024-06",
        "end_date": "2024-06"
      }
    ]
  }
}'

Additional Request Parameters

  • age_groups: Optional - specific age groups to filter
  • gender: Optional - gender filter (male, female)

Audience Interests (audience_interests)

Primary use case: Identifies websites frequently visited by the same audience and measures the overlap and affinity between different domains' visitors.

Primary Keys: domains, countries

Available Metrics:

Metric NameDescriptionSupported Granularity
desktop_audience_interests_affinityList of websites frequently visited by the same desktop visitors within the browsing session, with affinity scoreMonthly
mobile_audience_interests_affinityList of websites frequently visited by the same mobile visitors within the browsing session, with affinity scoreMonthly
desktop_audience_interests_overlapPercentage of visitors that visit both the analyzed domain and other domains on desktopMonthly
mobile_audience_interests_overlapPercentage of visitors that visit both the analyzed domain and other domains on mobileMonthly

Example Request

curl --location 'https://api.similarweb.com/batch/v4/request-report' \
--header 'api-key: {{API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
  "delivery_information": {
    "response_format": "csv",
    "delivery_method_params": {
      "retention_days": 60
    }
  },
  "report_query": {
    "tables": [
      {
        "vtable": "audience_interests",
        "granularity": "monthly",
        "filters": {
          "domains": [
            "similarweb.com",
            "google.com"
          ],
          "countries": [
            "WW",
            "US"
          ]
        },
        "metrics": [
          "desktop_audience_interests_affinity",
          "desktop_audience_interests_overlap",
          "mobile_audience_interests_affinity",
          "mobile_audience_interests_overlap"
        ],
        "start_date": "2024-06",
        "end_date": "2024-06"
      }
    ]
  }
}'

Updated about 20 hours ago

What’s Next