Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt

Use this file to discover all available pages before exploring further.

$8 / 1k websites Pull Similarweb website analytics including traffic, rank, and audience data for domains you provide

​
Endpoint

POST /api/v1/agents/similarweb/traffic/run

​
Parameters

​
websites
array
required
List · List of SimilarWeb websites to scrape. Enter domains.

​
Response columns

FieldDisplay nameType
domainDomaintext
similarwebUrlSimilarWeb URLurl
siteNameSite Nametext
titleTitletext
descriptionDescriptiontext
categoryCategorytext
screenshotScreenshoturl
globalRankGlobal Ranknumber
countryRankCountry Ranknumber
topCountryTop Countrytext
categoryRankCategory Ranknumber
rankCategoryRank Categorytext
visitsVisitsnumber
bounceRateBounce Ratepercentage
pagesVisitPages/Visitnumber
timeOnSiteSTime On Site (s)number
monthMonthtext
yearYeartext
directDirect %percentage
searchSearch %percentage
socialSocial %percentage
mailMail %percentage
referralsReferrals %percentage
paidReferralsPaid Referrals %percentage
topKeywordTop Keywordtext
topKeywordVolumeTop Keyword Volumenumber
topKeywordCpcTop Keyword CPCcurrency
topKeywordValueTop Keyword Valuecurrency
topCountryCodeTop Country Codetext
topCountryIdTop Country IDnumber
topCountryShareTop Country Sharepercentage
aiTrafficVisitsAI Traffic Visitsnumber
aiReferralAI Referral %percentage
aiTopPromptsAI Top Promptstext
aiDistributionAI Distributiontext
aiTopSourceAI Top Sourcetext
visitsJanVisits Jannumber
visitsFebVisits Febnumber
visitsMarVisits Marnumber
snapshotDateSnapshot Datetext
fromGaFrom GAboolean
smallSiteSmall Siteboolean
countryRankCountryCountry Rank Countryinteger

​
Example

curl -X POST https://api.mindcase.co/api/v1/agents/similarweb/traffic/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "websites": [
      "apple.com",
      "microsoft.com",
      "google.com",
      "twitter.com",
      "samsung.com",
      "hp.com",
      "dell.com",
      "mi.com",
      "lg.com",
      "sony.com"
    ]
  }
}'

​
Example response

Response
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "domain": "apple.com",
      "similarwebUrl": "https://similarweb.com/website/apple.com",
      "siteName": "apple.com",
      "title": "Privacy - Control",
      "description": "Apple products, including Apple Intelligence, are designed to protect your privacy, because privacy is a fundamental human right.",
      "category": "computers_electronics_and_technology/consumer_electronics",
      "screenshot": "https://site-images.similarcdn.com/image?url=apple.com&t=1&s=1&h=f81bb484ae2fd14ee7d230f4992fcf6f0e071e846a94e3f49400616e3f9c5063",
      "globalRank": 64,
      "countryRank": 53,
      "topCountry": "US",
      "categoryRank": "1",
      "rankCategory": "Computers_Electronics_and_Technology/Consumer_Electronics",
      "visits": "588832278",
      "bounceRate": "0.5129393764353296",
      "pagesVisit": "3.354272779567929",
      "timeOnSiteS": "148.33803595706115",
      "month": "3",
      "year": "2026",
      "direct": 0.35960863533970405,
      "search": 0.4263245993439161,
      "social": 0.06193439690061664,
      "mail": 0.01621194631885151,
      "referrals": 0.10405498156738144,
      "paidReferrals": 0.0130389173689122,
      "topKeyword": null,
      "topKeywordVolume": null,
      "topKeywordCpc": null,
      "topKeywordValue": null,
      "topCountryCode": null,
      "topCountryId": null,
      "topCountryShare": null,
      "aiTrafficVisits": 9532599.765,
      "aiReferral": 0.01665379677161558,
      "aiTopPrompts": [
        "What are the latest products from Apple?",
        "How can I contact Apple support?",
        "Where can I find information about Apple services?"
      ],
      "aiDistribution": {
        "Boundary": "<100M",
        "Chart": [
          {
            "Name": "chatgpt.com",
            "Icon": "/image?url=chatgpt.com&t=2&s=1&h=a31616ae3cdef12fcfc664127563e6092e7531e7b4c3cde7e0c8c5fd3310dfc0",
            "History": [
              {
                "Date": "2026-03-01",
                "Value": 79.62862458434495
              },
              {
                "Date": "2026-02-01",
                "Value": 60.88813069977872
              },
              {
                "Date": "2026-01-01",
                "Value": 68.51856666616276
              }
            ]
          },
          {
            "Name": "perplexity.ai",
            "Icon": "/image?url=perplexity.ai&t=2&s=1&h=f48fa93e79e65eef47bff5b62e7037bccffb0629aecaed2d0c9f2fb25f177362",
            "History": [
              {
                "Date": "2026-03-01",
                "Value": 6.160065097414693
              },
              {
                "Date": "2026-02-01",
                "Value": 5.080559783682474
              },
              {
                "Date": "2026-01-01",
                "Value": 5.617196171038447
              }
            ]
          },
          {
            "Name": "gemini.google.com",
            "Icon": "/image?url=gemini.google.com&t=2&s=1&h=ec0ae7eb3432025135e3658db1edf54cfa2710c74ca7f113d026db33002def01",
            "History": [
              {
                "Date": "2026-03-01",
                "Value": 4.763318981115326
              },
              {
                "Date": "2026-02-01",
                "Value": 3.4535472181339393
              },
              {
                "Date": "2026-01-01",
                "Value": 3.315362658572711
              }
            ]
          }
        ],
        "Chatbots": [
          {
            "Name": "chatgpt.com",
            "Icon": "/image?url=chatgpt.com&t=2&s=1&h=a31616ae3cdef12fcfc664127563e6092e7531e7b4c3cde7e0c8c5fd3310dfc0",
            "Value": 79.62862458434495
          },
          {
            "Name": "perplexity.ai",
            "Icon": "/image?url=perplexity.ai&t=2&s=1&h=f48fa93e79e65eef47bff5b62e7037bccffb0629aecaed2d0c9f2fb25f177362",
            "Value": 6.160065097414693
          },
          {
            "Name": "gemini.google.com",
            "Icon": "/image?url=gemini.google.com&t=2&s=1&h=ec0ae7eb3432025135e3658db1edf54cfa2710c74ca7f113d026db33002def01",
            "Value": 4.763318981115326
          }
        ]
      },
      "aiTopSource": [
        {
          "Name": "chatgpt.com",
          "Rank": 1,
          "Icon": "/image?url=chatgpt.com&t=2&s=1&h=a31616ae3cdef12fcfc664127563e6092e7531e7b4c3cde7e0c8c5fd3310dfc0"
        },
        {
          "Name": "perplexity.ai",
          "Rank": 2,
          "Icon": "/image?url=perplexity.ai&t=2&s=1&h=f48fa93e79e65eef47bff5b62e7037bccffb0629aecaed2d0c9f2fb25f177362"
        },
        {
          "Name": "gemini.google.com",
          "Rank": 3,
          "Icon": "/image?url=gemini.google.com&t=2&s=1&h=ec0ae7eb3432025135e3658db1edf54cfa2710c74ca7f113d026db33002def01"
        },
        {
          "Name": "chat.deepseek.com",
          "Rank": 4,
          "Icon": "/image?url=chat.deepseek.com&t=2&s=1&h=3932bcfb7ad820bd114ee43a2dba828a589d2ff19b6dc54400e0d39b2d65d377"
        },
        {
          "Name": "claude.ai",
          "Rank": 5,
          "Icon": "/image?url=claude.ai&t=2&s=1&h=a3b3778e02952b653132fb6d019ed0361cff7850429377787fbdc4c86ce1565e"
        },
        {
          "Name": "copilot.microsoft.com",
          "Rank": 6,
          "Icon": "/image?url=copilot.microsoft.com&t=2&s=1&h=eb2c5d699c15f4d7ff035602d8165b847ac5e2883d42a9d8eae54163cd4b47cb"
        },
        {
          "Name": "grok.com",
          "Rank": 7,
          "Icon": "/image?url=grok.com&t=2&s=1&h=5f2be8fd5c0911d0646a313793511a5a9acc4816f25a1b301774b501e7aa7c94"
        }
      ],
      "visitsJan": 530542800,
      "visitsFeb": 472601888,
      "visitsMar": 588832278,
      "snapshotDate": "2026-03-01T00:00:00+00:00",
      "fromGa": false,
      "smallSite": false,
      "countryRankCountry": 840
    }
  ]
}