--- updatedAt: 2025-11-07T23:54:26.000Z agentTools: projectIndex: https://developers.similarweb.com/llms.txt --- # Visits by Marketing Channel - Desktop Returns the estimated desktop visits by marketing channel (Organic Search, Paid Search, Direct, Display Ads, E-Mail, Referrals and Social) on desktop devices.
Device Granularity Metrics
desktop monthly,\ weekly,\ daily,\ last 28 days (daily, weekly) visits by marketing channel
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 **7 data credits** per [result](https://developers.similarweb.com/docs/data-credits-unpublished-whats-new-in-v40). # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "traffic-sources-overview-desktop", "version": "4.0" }, "servers": [ { "url": "https://api.similarweb.com/v1/website/" } ], "security": [ {} ], "paths": { "/{domain_name}/traffic-sources/overview-share": { "get": { "summary": "Visits by Marketing Channel - Desktop", "description": "Returns the estimated desktop visits by marketing channel (Organic Search, Paid Search, Direct, Display Ads, E-Mail, Referrals and Social) on desktop devices.", "operationId": "traffic-sources-overview", "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": "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" } } ], "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\": \"cnn.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 \"cnn.com\": [\n {\n \"source_type\": \"Search\",\n \"visits\": [\n {\n \"date\": \"2023-01-01\",\n \"organic\": 47006758.058137886,\n \"paid\": 8351.290702430571\n },\n {\n \"date\": \"2023-02-01\",\n \"organic\": 37363849.31215082,\n \"paid\": 6720.711800855647\n },\n {\n \"date\": \"2023-03-01\",\n \"organic\": 39914702.754355334,\n \"paid\": 4976.9661826344545\n }\n ]\n },\n {\n \"source_type\": \"Social\",\n \"visits\": [\n {\n \"date\": \"2023-01-01\",\n \"organic\": 4294729.910999237,\n \"paid\": 0\n },\n {\n \"date\": \"2023-02-01\",\n \"organic\": 3655762.7204748704,\n \"paid\": 0\n },\n {\n \"date\": \"2023-03-01\",\n \"organic\": 3773226.578360144,\n \"paid\": 0\n }\n ]\n },\n {\n \"source_type\": \"Mail\",\n \"visits\": [\n {\n \"date\": \"2023-01-01\",\n \"organic\": 1241207.6910725683,\n \"paid\": 0\n },\n {\n \"date\": \"2023-02-01\",\n \"organic\": 1195686.209487116,\n \"paid\": 0\n },\n {\n \"date\": \"2023-03-01\",\n \"organic\": 1537439.8916388783,\n \"paid\": 0\n }\n ]\n },\n {\n \"source_type\": \"Display Ads\",\n \"visits\": [\n {\n \"date\": \"2023-01-01\",\n \"organic\": 0,\n \"paid\": 174142.89905962715\n },\n {\n \"date\": \"2023-02-01\",\n \"organic\": 0,\n \"paid\": 144203.109172992\n },\n {\n \"date\": \"2023-03-01\",\n \"organic\": 0,\n \"paid\": 144510.16572073457\n }\n ]\n },\n {\n \"source_type\": \"Direct\",\n \"visits\": [\n {\n \"date\": \"2023-01-01\",\n \"organic\": 103288653.30495915,\n \"paid\": 0\n },\n {\n \"date\": \"2023-02-01\",\n \"organic\": 86346425.60706843,\n \"paid\": 0\n },\n {\n \"date\": \"2023-03-01\",\n \"organic\": 95649889.65965174,\n \"paid\": 0\n }\n ]\n },\n {\n \"source_type\": \"Referrals\",\n \"visits\": [\n {\n \"date\": \"2023-01-01\",\n \"organic\": 3896385.8538676584,\n \"paid\": 0\n },\n {\n \"date\": \"2023-02-01\",\n \"organic\": 3256733.9346165056,\n \"paid\": 0\n },\n {\n \"date\": \"2023-03-01\",\n \"organic\": 3317439.389167828,\n \"paid\": 0\n }\n ]\n }\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": "cnn.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": "object", "properties": { "cnn.com": { "type": "array", "items": { "type": "object", "properties": { "source_type": { "type": "string", "example": "Search" }, "visits": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2023-01-01" }, "organic": { "type": "number", "example": 47006758.058137886, "default": 0 }, "paid": { "type": "number", "example": 8351.290702430571, "default": 0 } } } } } } } } } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```