Websites Referrals Dataset

Uncover incoming and outgoing referral traffic data and insights for millions of websites.

Referral traffic represents the visitors who arrive on your site by clicking a link on other domains, not through a search engine or direct link.
With this valuable data you can analyze the traffic volume sent from referrals to your competitors, see the referral traffic share by industry distribution, get the breakdown of traffic sources by industry categories, and find opportunities to optimize your marketing strategies and partnerships.

👨‍🏫

Data credits are Similarweb's currency. Each result (cell) in a report costs one data credit. Each metric value for referral domains accounts for 1 credit + 1 credit for each domain revealed.

As pricing may vary from report to report you can estimate the total credit amount for each report generated by our Request-Validate endpoint.

*Note - if there are no results, no credits are charged.

🚧

The default limit for results is 100

You can change the limit by adding a "limit" parameter to the body.

📘

Batch API and REST API have different Keys

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

The Dataset is utilizing multiple tables.

Example request:

{
  "delivery_information": {
    "response_format": "csv",
    "delivery_method_params": {
      "retention_days": 60
    }
  },
  "report_query": {
    "tables": [
      {
        "vtable": "referrals",
        "granularity": "monthly",
        "filters": {
          "domains": [
            "similarweb.com",
            "google.com"
          ],
          "countries": [
            "WW",
            "US"
          ],
          "include_subdomains": true
        },
        "metrics": [
          "desktop_outgoing_referral_change",
          "desktop_outgoing_referral_share",
          "desktop_outgoing_referral_visits",
          "desktop_referral_change",
          "desktop_referral_share",
          "desktop_referral_visits",
          "mobile_referral_change",
          "mobile_referral_share",
          "mobile_referral_visits"
        ],
        "start_date": "2023-02",
        "end_date": "2023-04"
      }
    ]
  }
}

Referrals Table:

vtable: "referral"

Table URL: https://api.similarweb.com/batch/v4/request-report

Primary Keys: domains, countries

Metric NameDescriptionSupported GranularityType
desktop_referral_visits, mobile_referral_visitsReturns the desktop/mobile traffic visits of a referral, this metric is a one-to-many metric which means that for one key - a maximum of 1000 referrals values may be returned.MonthlyDouble
desktop_referral_share, mobile_referral_shareReturns the traffic share of each referral from the overall traffic to the selected site in the selected country, this metric is a one-to-many metric which means that for one key - a maximum of 1000 referrals values may be returned.MonthlyDouble
desktop_referral_change, mobile_referral_changeReturns the percentage of change in the traffic based on the selected period over the previous period, this metric is a one-to-many metric which means that for one key - a maximum of 1000 referrals values may be returned.MonthlyDouble
desktop_outgoing_referral_visitsReturns the desktop traffic visits of an outgoing referral, this metric is a one-to-many metric which means that for one key - 1000 referrals values may be returned.MonthlyDouble
desktop_outgoing_referral_shareReturns the traffic share of each referral from the overall traffic to the selected site in the selected country, this metric is a one-to-many metric which means that for one key - a maximum of 1000 outgoing referrals values may be returned.MonthlyDouble
desktop_outgoing_referral_changeReturns the percentage of change in the traffic based on the selected period over the previous period, this metric is a one-to-many metric which means that for one key - a maximum of 1000 outgoing referrals values may be returned.MonthlyDouble
Language
Authorization
Header
Click Try It! to start a request and see the response here!