Deprecation notice The legacy endpoints in the ,׳Old endpoint׳ column will be deprecated on October 6, 2026. Migrate to the V5 replacements linked below before this date to avoid disruption.

#### Mapping of legacy REST endpoints to their Similarweb API V5 replacements:

Category

Old endpoint

New endpoint (V5)

Traffic Channels

GET /v1/website/{domain}/traffic-sources/overview-share

GET /v5/website-analysis/websites/traffic-channels/share + web_source=desktop

Traffic Channels

GET /v4/website/{domain}/traffic-sources/overview

GET /v5/website-analysis/websites/traffic-channels/share + web_source=desktop

Traffic Channels

GET /v5/website/{domain}/mobile-traffic-sources/mobile-overview-share

GET /v5/website-analysis/websites/traffic-channels/share + web_source=mobile_web

Traffic Channels

GET /v5/website/{domain}/traffic-sources/marketing-channels

GET /v5/website-analysis/websites/traffic-channels

Traffic Channels

GET /v1/website/{domain}/traffic-sources/overview

GET /v5/website-analysis/websites/traffic-channels/share + web_source=desktop

Referrals — Incoming

GET /v4/website/{domain}/traffic-sources/referrals

GET /v5/website-analysis/websites/traffic-referrals/incoming + web_source=desktop

Referrals — Incoming

GET /v4/website/{domain}/traffic-sources/mobileweb-referrals

GET /v5/website-analysis/websites/traffic-referrals/incoming + web_source=mobile_web

Referrals — Incoming

GET /v5/website/{domain}/traffic-sources/referrals

GET /v5/website-analysis/websites/traffic-referrals/aggregated

Referrals — Outgoing

GET /v4/website/{domain}/traffic-sources/outgoing-referrals

GET /v5/website-analysis/websites/traffic-referrals/outgoing + web_source=desktop

Referrals — Outgoing

GET /v4/website/{domain}/traffic-sources/mobileweb-outgoing-referrals

GET /v5/website-analysis/websites/traffic-referrals/outgoing + web_source=mobile_web

Segments

GET /v1/segment/{segment_id}/marketing-channels/query

Coming soon

Segments

GET /v1/segment/{segment_id}/total-marketing-channels/query

Coming soon

Segments

GET /v5/segment/{segment}/traffic-sources/marketing-channels

Coming soon

Engagement Metrics

GET /v1/website/{domain}/traffic-and-engagement/average-visit-duration

Coming soon

PPC Spend

GET /v1/website/{domain}/ppc-spend/desktop

GET /v5/website-analysis/websites/ppc-spend + web_source=desktop & data_version=VERSION_6.0

PPC Spend

GET /v1/website/{domain}/ppc-spend/total

GET /v5/website-analysis/websites/ppc-spend + web_source=total & data_version=VERSION_6.0

PPC Spend

GET /v5/website-analysis/websites/ppc-spend

GET /v5/website-analysis/websites/ppc-spend + data_version=VERSION_6.0

Ad Networks

GET /v1/website/{domain}/traffic-sources/ad-networks

GET /v5/website-analysis/ad-networks/aggregated + ad_network_type=incoming & data_version=VERSION_6.0

Ad Networks

GET /v4/website/{domain}/traffic-sources/ad-network

GET /v5/website-analysis/ad-networks/aggregated + ad_network_type=incoming & data_version=VERSION_6.0

Ad Networks

GET /v1/website/{domain}/traffic-sources/outgoing-ads-adnetworks

GET /v5/website-analysis/ad-networks/aggregated + ad_network_type=outgoing & data_version=VERSION_6.0

Ad Networks

GET /v4/website/{domain}/traffic-sources/outgoing-ads-adnetworks

GET /v5/website-analysis/ad-networks/aggregated + ad_network_type=outgoing & data_version=VERSION_6.0

Ad Networks

GET /v1/website/{domain}/traffic-sources/outgoing-ads-advertisers

GET /v5/website-analysis/outgoing-ads/advertisers/aggregated

Ad Networks

GET /v4/website/{domain}/traffic-sources/outgoing-ads-advertisers

GET /v5/website-analysis/outgoing-ads/advertisers/aggregated

Ad Networks

GET /v5/website-analysis/ad-networks/aggregated

GET /v5/website-analysis/ad-networks/aggregated + data_version=VERSION_6.0

Incoming Publishers

GET /v1/website/{domain}/traffic-sources/publishers

GET /v5/website-analysis/publishers/aggregated

Incoming Publishers

GET /v4/website/{domain}/traffic-sources/publishers

GET /v5/website-analysis/publishers/aggregated

Publishers by Ad Networks

GET /v1/website/{domain}/traffic-sources/publishers-by-ad-networks

GET /v5/website-analysis/publishers-by-ad-networks/aggregated

Ad Networks by Publishers

GET /v1/website/{domain}/traffic-sources/ad-networks-by-publishers

GET /v5/website-analysis/ad-networks-by-publishers/aggregated

Ad Network Publishers

GET /v4/website/{domain}/traffic-sources/ad-network-publishers

GET /v5/website-analysis/ad-network-publishers/aggregated

Social Traffic

GET /v1/website/{domain}/traffic-sources/social

GET /v5/website-analysis/social-traffic/aggregated

Social Traffic

GET /v4/website/{domain}/traffic-sources/social

GET /v5/website-analysis/social-traffic/aggregated

#### **Notes** * `web_source` — desktop, mobile\_web, or total. Replaces the separate desktop / mobile-web endpoints from V1–V4. * `data_version=VERSION_6.0` — required to opt into v6 data on endpoints whose V5 base path already exists for legacy data.