---
updatedAt: 2025-11-07T23:53:56.000Z
agentTools:
  projectIndex: https://developers.similarweb.com/llms.txt
---

# Visits - Total (Desktop & Mobile)

Returns the estimated number of all visits to a given domain: desktop and mobile visits combined. Historical data goes back 37 months, depending on your subscription.

<Table>
  <thead>
    <tr>
      <th>
        Device
      </th>

      <th>
        Granularity
      </th>

      <th>
        Metrics
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        total: desktop and mobile combined
      </td>

      <td>
        monthly,\
        weekly,\
        daily,\
        last 28 days (daily, weekly)
      </td>

      <td>
        visits
      </td>
    </tr>
  </tbody>
</Table>

To retrieve Last 28 days remove the start\_date & end\_date parameters and set granularity to daily or weekly.

> 📘 Price
>
> **1 hit** per request or **1 data credit** per [result](https://developers.similarweb.com/docs/data-credits-unpublished-whats-new-in-v40).

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "visits-total-traffic",
    "version": "4.0"
  },
  "servers": [
    {
      "url": "https://api.similarweb.com/v1/website/"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/{domain_name}/total-traffic-and-engagement/visits": {
      "get": {
        "summary": "Visits - Total (Desktop & Mobile)",
        "description": "Returns the estimated number of all visits to a given domain: desktop and mobile visits combined. Historical data goes back 37 months, depending on your subscription.",
        "operationId": "visits",
        "parameters": [
          {
            "name": "domain_name",
            "in": "path",
            "description": "Enter website of interest, without 'www.' or brackets {}",
            "schema": {
              "type": "string",
              "default": "amazon.com"
            },
            "required": true
          },
          {
            "name": "api_key",
            "in": "query",
            "description": "Your Similarweb API key.",
            "required": true,
            "schema": {
              "type": "string",
              "default": "Add_Your_API_KEY"
            }
          },
          {
            "name": "start_date",
            "in": "query",
            "description": "Start month (format: YYYY-MM)",
            "schema": {
              "type": "string",
              "default": "2023-01"
            }
          },
          {
            "name": "end_date",
            "in": "query",
            "description": "End month (format: YYYY-MM)",
            "schema": {
              "type": "string",
              "default": "2023-03"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "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.",
            "required": true,
            "schema": {
              "type": "string",
              "default": "us"
            }
          },
          {
            "name": "granularity",
            "in": "query",
            "description": "Set the granularity for the returned values. Can be 'daily', 'weekly' or 'monthly'.",
            "required": true,
            "schema": {
              "type": "string",
              "default": "monthly"
            }
          },
          {
            "name": "main_domain_only",
            "in": "query",
            "description": "[optional] Return values for the main domain only ('true'), or include also the subdomains ('false')",
            "schema": {
              "type": "string",
              "default": "false"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "[optional] Format in which the reply should be returned. Possible values: 'json' (default) or 'xml'",
            "schema": {
              "type": "string",
              "default": "json"
            }
          },
          {
            "name": "show_verified",
            "in": "query",
            "description": "[optional] Show shared Google Analytics data when available. Default value is 'false'",
            "schema": {
              "type": "string",
              "default": "false"
            }
          },
          {
            "name": "mtd",
            "in": "query",
            "description": "[optional] When 'true', end_date is set to the latest available days' data (month-to-date). To use, set granularity to 'daily'. Default value is 'false'.",
            "schema": {
              "type": "string",
              "default": "false"
            }
          },
          {
            "name": "engaged_only",
            "in": "query",
            "description": "[optional] When 'true', the data is filtered by 'engaged visits' only.",
            "schema": {
              "type": "string",
              "default": "false"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "VIEW EXAMPLE RESPONSE": {
                    "value": "{\n  \"meta\": {\n    \"request\": {\n      \"granularity\": \"Monthly\",\n      \"main_domain_only\": false,\n      \"mtd\": false,\n      \"show_verified\": false,\n      \"state\": null,\n      \"format\": \"json\",\n      \"domain\": \"amazon.com\",\n      \"start_date\": \"2023-01-01\",\n      \"end_date\": \"2023-03-31\",\n      \"country\": \"us\"\n    },\n    \"status\": \"Success\",\n    \"last_updated\": \"2023-05-31\"\n  },\n  \"visits\": [\n    {\n      \"date\": \"2023-01-01\",\n      \"visits\": 1999194357.4757116\n    },\n    {\n      \"date\": \"2023-02-01\",\n      \"visits\": 1704668417.8515935\n    },\n    {\n      \"date\": \"2023-03-01\",\n      \"visits\": 1881618852.1494892\n    }\n  ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "meta": {
                      "type": "object",
                      "properties": {
                        "request": {
                          "type": "object",
                          "properties": {
                            "granularity": {
                              "type": "string",
                              "example": "Monthly"
                            },
                            "main_domain_only": {
                              "type": "boolean",
                              "example": false,
                              "default": true
                            },
                            "mtd": {
                              "type": "boolean",
                              "example": false,
                              "default": true
                            },
                            "show_verified": {
                              "type": "boolean",
                              "example": false,
                              "default": true
                            },
                            "state": {},
                            "format": {
                              "type": "string",
                              "example": "json"
                            },
                            "domain": {
                              "type": "string",
                              "example": "amazon.com"
                            },
                            "start_date": {
                              "type": "string",
                              "example": "2023-01-01"
                            },
                            "end_date": {
                              "type": "string",
                              "example": "2023-03-31"
                            },
                            "country": {
                              "type": "string",
                              "example": "us"
                            }
                          }
                        },
                        "status": {
                          "type": "string",
                          "example": "Success"
                        },
                        "last_updated": {
                          "type": "string",
                          "example": "2023-05-31"
                        }
                      }
                    },
                    "visits": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "date": {
                            "type": "string",
                            "example": "2023-01-01"
                          },
                          "visits": {
                            "type": "number",
                            "example": 1999194357.4757116,
                            "default": 0
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```