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:
POST https://api.similarweb.com/v3/batch/referrals/request-report
{
"domains":[
"paypal.com", "stripe.com"
],
"countries": ["WW"],
"metrics":[
"desktop_referral_visits",
"desktop_referral_share",
"desktop_referral_change",
"mobile_referral_visits",
"mobile_referral_share",
"mobile_referral_change",
"desktop_outgoing_referral_visits",
"desktop_outgoing_referral_share",
"desktop_outgoing_referral_change"
],
"start_date": "2023-01",
"end_date": "2023-06",
"limit": 100,
"granularity": "monthly",
"subdomains":true,
"delivery_method": "download_link",
"response_format": "csv"
}
Referrals Table:
Table URL: https://api.similarweb.com/v3/batch/referrals/request-report
Primary Keys: domains, countries
| Metric Name | Description | Supported Granularity | Type |
|---|---|---|---|
| desktop_referral_visits, mobile_referral_visits | Returns 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. | Monthly | Double |
| desktop_referral_share, mobile_referral_share | Returns 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. | Monthly | Double |
| desktop_referral_change, mobile_referral_change | Returns 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. | Monthly | Double |
| desktop_outgoing_referral_visits | Returns 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. | Monthly | Double |
| desktop_outgoing_referral_share | Returns 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. | Monthly | Double |
| desktop_outgoing_referral_change | Returns 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. | Monthly | Double |