Use Similarweb to retrieve website traffic estimates, visit duration, bounce rate, pages per visit, country breakdowns, rankings, and traffic sources. Compare sites or report changes across the selected periods.
These are provider estimates rather than your site's measured analytics. Use the selected operation's geographic, time-period, and granularity fields to keep comparisons consistent.
Retrieve website analytics including traffic estimates, engagement metrics, rankings, and traffic sources using the Similarweb API.
Get website traffic, rankings, engagement, and traffic sources.
Parameter Type Required Description apiKeystring Yes SimilarWeb API key domainstring Yes Website domain to analyze (e.g., "example.com" without www or protocol)
Parameter Type Description siteNamestring Website name descriptionstring Website description globalRanknumber Global traffic rank countryRanknumber Country traffic rank categoryRanknumber Category traffic rank categorystring Website category monthlyVisitsnumber Estimated monthly visits engagementVisitDurationnumber Average visit duration in seconds engagementPagesPerVisitnumber Average pages per visit engagementBounceRatenumber Bounce rate (0-1) topCountriesarray Top countries by traffic share ↳ country string Country code ↳ share number Traffic share (0-1) trafficSourcesjson Traffic source breakdown ↳ direct number Direct traffic share ↳ referrals number Referral traffic share ↳ search number Search traffic share ↳ social number Social traffic share ↳ mail number Email traffic share ↳ paidReferrals number Paid referral traffic share
Get total website visits over time (desktop and mobile combined)
Parameter Type Required Description apiKeystring Yes SimilarWeb API key domainstring Yes Website domain to analyze (e.g., "example.com" without www or protocol) countrystring Yes 2-letter ISO country code (e.g., "us", "gb", "de") or "world" for worldwide data granularitystring Yes Data granularity: daily, weekly, or monthly startDatestring No Start date in YYYY-MM format (e.g., "2024-01") endDatestring No End date in YYYY-MM format (e.g., "2024-12") mainDomainOnlyboolean No Exclude subdomains from results
Parameter Type Description domainstring Analyzed domain countrystring Country filter applied granularitystring Data granularity lastUpdatedstring Data last updated timestamp visitsarray Visit data over time ↳ date string Date (YYYY-MM-DD) ↳ visits number Number of visits
Get website bounce rate over time (desktop and mobile combined)
Parameter Type Required Description apiKeystring Yes SimilarWeb API key domainstring Yes Website domain to analyze (e.g., "example.com" without www or protocol) countrystring Yes 2-letter ISO country code (e.g., "us", "gb", "de") or "world" for worldwide data granularitystring Yes Data granularity: daily, weekly, or monthly startDatestring No Start date in YYYY-MM format (e.g., "2024-01") endDatestring No End date in YYYY-MM format (e.g., "2024-12") mainDomainOnlyboolean No Exclude subdomains from results
Parameter Type Description domainstring Analyzed domain countrystring Country filter applied granularitystring Data granularity lastUpdatedstring Data last updated timestamp bounceRatearray Bounce rate data over time ↳ date string Date (YYYY-MM-DD) ↳ bounceRate number Bounce rate (0-1)
Get average pages per visit over time (desktop and mobile combined)
Parameter Type Required Description apiKeystring Yes SimilarWeb API key domainstring Yes Website domain to analyze (e.g., "example.com" without www or protocol) countrystring Yes 2-letter ISO country code (e.g., "us", "gb", "de") or "world" for worldwide data granularitystring Yes Data granularity: daily, weekly, or monthly startDatestring No Start date in YYYY-MM format (e.g., "2024-01") endDatestring No End date in YYYY-MM format (e.g., "2024-12") mainDomainOnlyboolean No Exclude subdomains from results
Parameter Type Description domainstring Analyzed domain countrystring Country filter applied granularitystring Data granularity lastUpdatedstring Data last updated timestamp pagesPerVisitarray Pages per visit data over time ↳ date string Date (YYYY-MM-DD) ↳ pagesPerVisit number Average pages per visit
Get average desktop visit duration over time (in seconds)
Parameter Type Required Description apiKeystring Yes SimilarWeb API key domainstring Yes Website domain to analyze (e.g., "example.com" without www or protocol) countrystring Yes 2-letter ISO country code (e.g., "us", "gb", "de") or "world" for worldwide data granularitystring Yes Data granularity: daily, weekly, or monthly startDatestring No Start date in YYYY-MM format (e.g., "2024-01") endDatestring No End date in YYYY-MM format (e.g., "2024-12") mainDomainOnlyboolean No Exclude subdomains from results
Parameter Type Description domainstring Analyzed domain countrystring Country filter applied granularitystring Data granularity lastUpdatedstring Data last updated timestamp averageVisitDurationarray Desktop visit duration data over time ↳ date string Date (YYYY-MM-DD) ↳ durationSeconds number Average visit duration in seconds
Get total page views over time (desktop and mobile combined)
Parameter Type Required Description apiKeystring Yes SimilarWeb API key domainstring Yes Website domain to analyze (e.g., "example.com" without www or protocol) countrystring Yes 2-letter ISO country code (e.g., "us", "gb", "de") or "world" for worldwide data granularitystring Yes Data granularity: daily, weekly, or monthly startDatestring No Start date in YYYY-MM format (e.g., "2024-01") endDatestring No End date in YYYY-MM format (e.g., "2024-12") mainDomainOnlyboolean No Exclude subdomains from results
Parameter Type Description domainstring Analyzed domain countrystring Country filter applied granularitystring Data granularity lastUpdatedstring Data last updated timestamp pageViewsarray Page view data over time ↳ date string Date (YYYY-MM-DD) ↳ pageViews number Total page views