Websites Referrals Dataset

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