Skip to main content
POST
/
traffic
Get traffic
curl --request POST \
  --url https://api.decodo.com/api/v2/statistics/traffic \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "proxyType": "residential_proxies",
  "startDate": "2024-09-01 00:00:00",
  "endDate": "2024-10-01 00:00:00",
  "proxyUsers": [
    "<string>"
  ],
  "groupBy": "target",
  "targets": [
    "<string>"
  ],
  "locations": [
    "<string>"
  ],
  "limit": 500,
  "page": 1,
  "sortBy": "grouping_key",
  "sortOrder": "asc",
  "protocols": [
    "<string>"
  ]
}
'
"{}"

Authorizations

​
Authorization
string
header
required

Body

application/json
​
proxyType
enum<string>
default:residential_proxies

RTC proxies are Scraping APIs

Available options:
residential_proxies,
mobile_proxies,
rtc_universal_proxies,
rtc_universal_core_proxies,
modular_scraper
​
startDate
string
default:2024-09-01 00:00:00

Max date return interval is 180 days. Date in this format: YYYY-MM-DD HH:MM:SS

​
endDate
string
default:2024-10-01 00:00:00

Max date return interval is 180 days. Date in this format: YYYY-MM-DD HH:MM:SS

​
proxyUsers
string[]

A list of proxy user IDs retrieved from here (only available for residential_proxies). Not applicable to RTC proxies (Scraping APIs)

​
groupBy
enum<string>
default:target

Group results by. hour shows last day usage every hour, but you must have used traffic within last 2 weeks for it to show.

Available options:
day,
target,
country,
protocol,
proxy_user,
hour,
week,
month
​
targets
string[]

A list (array) of target URLs

​
locations
string[]

A list of locations to filter the results by in ISO-2 format (IT, US, ES..). Not applicable to RTC proxies (Scraping APIs)

​
limit
integer<int32>
default:500

How many items to return

​
page
integer<int32>
default:1

Page number to return

​
sortBy
enum<string>
default:grouping_key

Desired way to group the response by

Available options:
grouping_key,
requests,
totals
​
sortOrder
enum<string>
default:asc

Sort order: ascending or descending

Available options:
asc,
desc
​
protocols
string[]

Valid protocols: http, https, socks5. Empty will return all protocols. Not applicable to RTC proxies (Scraping APIs)

Response

200

The response is of type object.