v1

latestOpenAPI 3.1.02026-07-2414103.5 MB

Publishers Per Ad Network - Desktop

Returns the top publishers per ad network for a given domain, and their traffic share.

get/{domain_name}/traffic-sources/ad-network-publishers

Path parameters

domain_namestring required

Enter website of interest, without 'www.' or brackets {}.

Query parameters

api_keystring required

Your Similarweb API key.

start_datestring

Start month (format: YYYY-MM)

end_datestring

End month (format: YYYY-MM)

countrystring required

Country filter, as a 2-letter ISO country code, or "world" for worldwide. To see the country filters you have access to, please refer to the Check Capabilities endpoint.

AdNetworkstring required

Input an Ad Network. To discover Ad Networks sending traffic to a domain, use 'Ad Networks - Desktop' endpoint.

main_domain_onlystring

[optional] Return values for the main domain only ('true'), or include also the subdomains ('false').

formatstring

[optional] Format in which the reply should be returned. Possible values: 'json' (default) or 'xml'.

limitstring

[optional] Select the number of results that are returned. Default = 100.

offsetstring

[optional] Specify an offset from where to start returning data.

sortstring

[optional] The metric you'd like the results to be ordered by.

ascstring

[optional] The order of results. Enter "true" for ascending, or "false" for descending.

Response

200

Example response

{
  "meta": {
    "query": {
      "limit": 100
    },
    "request": {
      "ad_network": "Outbrain",
      "format": "json",
      "domain": "cnn.com",
      "start_date": "2023-01-01",
      "end_date": "2023-03-31",
      "country": "us"
    },
    "status": "Success",
    "last_updated": "2023-05-31"
  },
  "publishers": [
    {
      "domain": "youtube.com",
      "share": 0.21250682782437993
    }
  ]
}