Skip to content
Examples

Get Results

Retrieve scraped data from Similarweb Scraper

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your Similarweb Scraper runs. One row per website. Add-on fields are only populated when the matching add-on (company_details, ai_traffic, competitor_details) is enabled.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY.

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from.

pageintegerquery

Page number (default: 1).

Result Fields

Export Websites

domain_namestring

Domain the row describes, as Similarweb indexes it. Example: github.com

source_urlstring

Similarweb page this row was collected from.

scraped_atdatetime

UTC timestamp of the collection.

snapshot_datedatetime

Month Similarweb's snapshot covers. Similarweb publishes one snapshot per month.

has_traffic_databoolean

False when Similarweb tracks no traffic for this domain: the row is kept but every metric is empty.

descriptiontext

Website description as published by Similarweb.

categorystring

Similarweb category the website is ranked in.

iconstring

Favicon of the website.

preview_desktopstring

Desktop screenshot of the website.

preview_mobilestring

Mobile screenshot of the website.

global_rankinteger

Worldwide traffic rank, all categories.

global_rank_changeinteger

Change of the global rank versus the previous month.

global_rank_previousinteger

Global rank of the previous month.

global_rank_historyjson

Global rank of the last 3 months.

country_codestring

Country the country rank refers to (the website's leading country).

country_rankinteger

Traffic rank inside the leading country.

country_rank_changeinteger

Change of the country rank versus the previous month.

country_rank_previousinteger

Country rank of the previous month.

country_rank_historyjson

Country rank of the last 3 months.

category_rankinteger

Traffic rank inside the website's category.

category_rank_changeinteger

Change of the category rank versus the previous month.

category_rank_previousinteger

Category rank of the previous month.

category_rank_historyjson

Category rank of the last 3 months.

visitsfloat

Estimated visits over the snapshot month.

visits_changefloat

Change of the monthly visits versus the previous month.

bounce_ratefloat

Share of visits that bounce, between 0 and 1.

pages_per_visitfloat

Average number of pages seen per visit.

avg_visit_durationinteger

Average visit duration in seconds.

avg_visit_duration_formattedstring

Average visit duration as published (HH:MM:SS).

traffic_historyjson

3-month traffic trend. Similarweb publishes it as a percentage of the chart scale, not as visit counts.

graph_visits_gradestring

Scale of the traffic chart Similarweb draws for this website. Example: <1B

traffic_sourcesjson

The 10 marketing channels with their ranking. Similarweb only discloses the share of the leading channel to logged-out callers: the other channels carry rank only and a null percentage.

organic_search_sharefloat

Share of search traffic that is organic.

paid_search_sharefloat

Share of search traffic that is paid.

keywords_total_countbigint

Number of keywords the website ranks on.

top_keywordsjson

5 top keywords with their cost per click. Volume and estimated value are paywalled by Similarweb for logged-out callers and always come back empty.

top_countriesjson

5 countries sending the most traffic.

countries_total_countinteger

Number of countries sending traffic to the website.

age_distributionjson

Age brackets of the audience with their share.

gender_malefloat

Share of male visitors.

gender_femalefloat

Share of female visitors.

top_social_networksjson

5 social networks sending the most traffic.

social_networks_total_countinteger

Number of social networks sending traffic.

top_referral_sitesjson

6 websites sending the most referral traffic. Similarweb hides the domain of the top rows from logged-out callers (is_locked), the share is always given.

referral_sites_total_countinteger

Number of websites sending referral traffic.

top_incoming_categoriesjson

Categories the referral traffic comes from.

top_outgoing_sitesjson

6 websites receiving the most outgoing traffic.

outgoing_sites_total_countinteger

Number of websites receiving outgoing traffic.

top_outgoing_categoriesjson

Categories the outgoing traffic goes to.

top_ads_sitesjson

5 websites sending the most display-ads traffic.

ads_sites_total_countinteger

Number of websites sending display-ads traffic.

ads_networks_total_countinteger

Number of ad networks used.

technologiesjson

Leading technology per technology category.

technologies_total_countinteger

Number of technologies detected on the website.

top_interested_categoriesjson

Categories this audience is also interested in.

top_interested_topicsjson

Topics this audience is also interested in.

top_interested_websitesjson

Websites this audience also visits.

similar_competitorsjson

10 closest competitors with their affinity score.

company_namestring

Company operating the website.

company_year_foundedinteger

Year the company was founded.

company_employees_mininteger

Lower bound of the employee range.

company_employees_maxinteger

Upper bound of the employee range.

company_revenue_minbigint

Lower bound of the yearly revenue range.

company_revenue_maxbigint

Upper bound of the yearly revenue range.

company_revenue_currencystring

Currency of the revenue range.

company_headquarter_citystring

City of the company headquarters.

company_headquarter_country_codestring

Country of the company headquarters.

company_headquarter_state_codeinteger

Similarweb internal code of the headquarters state.

company_categorystring

Category of the company.

company_parent_domainstring

Parent domain of the company.

is_data_from_gaboolean

True when the figures come from a Google Analytics account connected by the website owner.

is_invalid_traffic_databoolean

True when Similarweb flags the traffic data as invalid.

Company Details

monthly_visitsjson

Exact monthly visit counts of the last 3 months.

monthly_avg_durationjson

Average visit duration of the last 3 months.

monthly_pages_per_visitjson

Pages per visit of the last 3 months.

revenue_by_yearjson

Yearly revenue estimate per year.

company_typestring

Private or public company.

company_emailstring

Public contact email of the company.

company_phonestring

Public phone number of the company.

company_twitterstring

Twitter profile of the company.

company_facebookstring

Facebook page of the company.

company_linkedinstring

LinkedIn page of the company.

stocks_tickersstring

Stock tickers of the company when it is listed.

subsidiariesjson

Domains owned by the company.

signalsjson

Dated company news Similarweb collects.

company_competitorsjson

Competing companies with their firmographics and total visits.

AI Traffic

ai_referral_traffic_sharefloat

Share of the website traffic referred by AI assistants.

ai_total_visitsfloat

Visits referred by AI assistants over the month.

ai_traffic_splitjson

The 7 AI assistants ranked by the traffic they send.

ai_engine_distributionjson

Share of the AI referral traffic per assistant, in percent. Similarweb only values the top 3.

ai_engine_historyjson

3-month history of the share per AI assistant.

ai_distribution_boundarystring

Scale of the AI traffic chart.

Competitor Details

competitors_detailedjson

The 10 closest competitors with their full metrics (description, screenshots, bounce rate, visit duration, pages per visit, global/country/category ranks and their monthly change, category, company name, affinity).

Code Examples

curl -G https://api.lobstr.io/v1/results \
  -H "Authorization: Token YOUR_API_KEY" \
  -d "squid=YOUR_SQUID_HASH" \
  -d "page=1"

Response

200
{"total_results": 1, "data": [{"domain_name": "github.com", "source_url": "https://www.similarweb.com/website/github.com/", "snapshot_date": "2026-08-01T00:00:00+00:00", "description": "Join the world's most widely adopted, AI-powered developer platform", "category": "computers_electronics_and_technology/programming_and_developer_software", "global_rank": 50, "country_code": "US", "country_rank": 81, "visits": 649321442.0, "bounce_rate": 0.3665509655, "pages_per_visit": 5.767678566, "avg_visit_duration": 384}]}