List top destination domains

GET

/analytics/domains

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.proxyrequest.com/api/v1/analytics/domains?end=2026-07-01T00%3A00%3A00Z&hostname=example.com%2Capi.example.com&include_sub_users=true&ledger_id=550e8400-e29b-41d4-a716-446655440005&ordering=-data&package_id=550e8400-e29b-41d4-a716-446655440002&start=2026-07-01T00%3A00%3A00Z&timezone=UTC&user_id=550e8400-e29b-41d4-a716-446655440001");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Accept-Language: de");
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Get,
    RequestUri = new Uri("https://api.proxyrequest.com/api/v1/analytics/domains?end=2026-07-01T00%3A00%3A00Z&hostname=example.com%2Capi.example.com&include_sub_users=true&ledger_id=550e8400-e29b-41d4-a716-446655440005&ordering=-data&package_id=550e8400-e29b-41d4-a716-446655440002&start=2026-07-01T00%3A00%3A00Z&timezone=UTC&user_id=550e8400-e29b-41d4-a716-446655440001"),
    Headers =
    {
        { "Accept-Language", "de" },
        { "Authorization", "Bearer <token>" },
    },
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {

  url := "https://api.proxyrequest.com/api/v1/analytics/domains?end=2026-07-01T00%3A00%3A00Z&hostname=example.com%2Capi.example.com&include_sub_users=true&ledger_id=550e8400-e29b-41d4-a716-446655440005&ordering=-data&package_id=550e8400-e29b-41d4-a716-446655440002&start=2026-07-01T00%3A00%3A00Z&timezone=UTC&user_id=550e8400-e29b-41d4-a716-446655440001"

  req, _ := http.NewRequest("GET", url, nil)

  req.Header.Add("Accept-Language", "de")
  req.Header.Add("Authorization", "Bearer <token>")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.proxyrequest.com/api/v1/analytics/domains?end=2026-07-01T00%3A00%3A00Z&hostname=example.com%2Capi.example.com&include_sub_users=true&ledger_id=550e8400-e29b-41d4-a716-446655440005&ordering=-data&package_id=550e8400-e29b-41d4-a716-446655440002&start=2026-07-01T00%3A00%3A00Z&timezone=UTC&user_id=550e8400-e29b-41d4-a716-446655440001"))
    .header("Accept-Language", "de")
    .header("Authorization", "Bearer <token>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://api.proxyrequest.com/api/v1/analytics/domains?end=2026-07-01T00%3A00%3A00Z&hostname=example.com%2Capi.example.com&include_sub_users=true&ledger_id=550e8400-e29b-41d4-a716-446655440005&ordering=-data&package_id=550e8400-e29b-41d4-a716-446655440002&start=2026-07-01T00%3A00%3A00Z&timezone=UTC&user_id=550e8400-e29b-41d4-a716-446655440001")
  .get()
  .addHeader("Accept-Language", "de")
  .addHeader("Authorization", "Bearer <token>")
  .build();

Response response = client.newCall(request).execute();

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.proxyrequest.com/api/v1/analytics/domains',
  params: {
    end: '2026-07-01T00:00:00Z',
    hostname: 'example.com,api.example.com',
    include_sub_users: 'true',
    ledger_id: '550e8400-e29b-41d4-a716-446655440005',
    ordering: '-data',
    package_id: '550e8400-e29b-41d4-a716-446655440002',
    start: '2026-07-01T00:00:00Z',
    timezone: 'UTC',
    user_id: '550e8400-e29b-41d4-a716-446655440001'
  },
  headers: {'Accept-Language': 'de', Authorization: 'Bearer <token>'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

const url = 'https://api.proxyrequest.com/api/v1/analytics/domains?end=2026-07-01T00%3A00%3A00Z&hostname=example.com%2Capi.example.com&include_sub_users=true&ledger_id=550e8400-e29b-41d4-a716-446655440005&ordering=-data&package_id=550e8400-e29b-41d4-a716-446655440002&start=2026-07-01T00%3A00%3A00Z&timezone=UTC&user_id=550e8400-e29b-41d4-a716-446655440001';
const options = {
  method: 'GET',
  headers: {'Accept-Language': 'de', Authorization: 'Bearer <token>'}
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

val client = OkHttpClient()

val request = Request.Builder()
  .url("https://api.proxyrequest.com/api/v1/analytics/domains?end=2026-07-01T00%3A00%3A00Z&hostname=example.com%2Capi.example.com&include_sub_users=true&ledger_id=550e8400-e29b-41d4-a716-446655440005&ordering=-data&package_id=550e8400-e29b-41d4-a716-446655440002&start=2026-07-01T00%3A00%3A00Z&timezone=UTC&user_id=550e8400-e29b-41d4-a716-446655440001")
  .get()
  .addHeader("Accept-Language", "de")
  .addHeader("Authorization", "Bearer <token>")
  .build()

val response = client.newCall(request).execute()

use reqwest;

#[tokio::main]
pub async fn main() {
    let url = "https://api.proxyrequest.com/api/v1/analytics/domains";

    let querystring = [
        ("end", "2026-07-01T00:00:00Z"),
        ("hostname", "example.com,api.example.com"),
        ("include_sub_users", "true"),
        ("ledger_id", "550e8400-e29b-41d4-a716-446655440005"),
        ("ordering", "-data"),
        ("package_id", "550e8400-e29b-41d4-a716-446655440002"),
        ("start", "2026-07-01T00:00:00Z"),
        ("timezone", "UTC"),
        ("user_id", "550e8400-e29b-41d4-a716-446655440001"),
    ];

    let mut headers = reqwest::header::HeaderMap::new();
    headers.insert("Accept-Language", "de".parse().unwrap());
    headers.insert("Authorization", "Bearer <token>".parse().unwrap());

    let client = reqwest::Client::new();
    let response = client.get(url)
        .query(&querystring)
        .headers(headers)
        .send()
        .await;

    let results = response.unwrap()
        .json::<serde_json::Value>()
        .await
        .unwrap();

    dbg!(results);
}

curl --request GET \
  --url 'https://api.proxyrequest.com/api/v1/analytics/domains?end=2026-07-01T00%3A00%3A00Z&hostname=example.com%2Capi.example.com&include_sub_users=true&ledger_id=550e8400-e29b-41d4-a716-446655440005&ordering=-data&package_id=550e8400-e29b-41d4-a716-446655440002&start=2026-07-01T00%3A00%3A00Z&timezone=UTC&user_id=550e8400-e29b-41d4-a716-446655440001' \
  --header 'Accept-Language: de' \
  --header 'Authorization: Bearer <token>'

wget --quiet \
  --method GET \
  --header 'Accept-Language: de' \
  --header 'Authorization: Bearer <token>' \
  --output-document \
  - 'https://api.proxyrequest.com/api/v1/analytics/domains?end=2026-07-01T00%3A00%3A00Z&hostname=example.com%2Capi.example.com&include_sub_users=true&ledger_id=550e8400-e29b-41d4-a716-446655440005&ordering=-data&package_id=550e8400-e29b-41d4-a716-446655440002&start=2026-07-01T00%3A00%3A00Z&timezone=UTC&user_id=550e8400-e29b-41d4-a716-446655440001'

Aggregates request count and transferred bytes by destination hostname for the selected reporting window and account scope.

Authorizations

BearerAuth
StaticAuth

Parameters

Query Parameters

end

string

Exclusive end of the reporting window. Defaults to the current time. Accepts ISO 8601 datetime strings with or without a timezone offset (including Z and fractional seconds), YYYY-MM-DD HH:MM:SS, DD-MM-YYYY HH:MM:SS, YYYY-MM-DD, DD-MM-YYYY, or a Unix timestamp in seconds (including fractional seconds, not milliseconds). Datetime strings without an offset and date-only strings use the requested timezone; explicit offsets are converted to that timezone. Date-only values start at midnight. Seconds and fractional seconds are discarded, rounding the reporting boundary down to the minute. Prefer ISO 8601 with an explicit offset for unambiguous timezone handling.

Examples

ISO UTC

2026-07-01T00:00:00Z

ISO offset

2026-07-01T03:00:00.123+03:00

ISO local datetime

2026-07-01T00:00:00

Local datetime

2026-07-01 00:00:00

Day-first datetime

01-07-2026 00:00:00

ISO date

2026-07-01

Day-first date

01-07-2026

Unix seconds

1782864000

Fractional Unix seconds

1782864000.5

hostname

string

Comma-separated domains, IPv4/IPv6 addresses or HTTP(S) URLs to include. Surrounding whitespace is ignored. URLs and host:port values are normalized to their hostname; schemes, ports, paths and IPv6 brackets are removed. Use brackets around IPv6 addresses when specifying a port.

Examples

example.com,api.example.com

Mixed destinations

https://example.com:443/path,192.0.2.1,[2001:db8::1]:8080

include_sub_users

boolean

Aggregate the selected user’s data with all of their sub-users. Superusers can apply this to any selected user; resellers can apply it to their own account. Ignored for regular users. Use true or false. Defaults to false.

Examples

Include sub-users

true

Selected user only

false

ledger_id

string format: uuid

Restrict results to one data ledger when supported.

Examples

Ledger

550e8400-e29b-41d4-a716-446655440005

limit

integer

Maximum records returned on this page.

offset

integer

Zero-based number of matching records to skip.

ordering

string

default: -data

Allowed values: -data -requests data requests

Sort domains by transferred data or request count.

package_id

string format: uuid

Restrict results to one purchased package.

Examples

Package

550e8400-e29b-41d4-a716-446655440002

search

string

Case-insensitive partial match against the listed field: hostname.

start

string

Inclusive start of the reporting window. Defaults to a recent window. Accepts ISO 8601 datetime strings with or without a timezone offset (including Z and fractional seconds), YYYY-MM-DD HH:MM:SS, DD-MM-YYYY HH:MM:SS, YYYY-MM-DD, DD-MM-YYYY, or a Unix timestamp in seconds (including fractional seconds, not milliseconds). Datetime strings without an offset and date-only strings use the requested timezone; explicit offsets are converted to that timezone. Date-only values start at midnight. Seconds and fractional seconds are discarded, rounding the reporting boundary down to the minute. Prefer ISO 8601 with an explicit offset for unambiguous timezone handling.

Examples

ISO UTC

2026-07-01T00:00:00Z

ISO offset

2026-07-01T03:00:00.123+03:00

ISO local datetime

2026-07-01T00:00:00

Local datetime

2026-07-01 00:00:00

Day-first datetime

01-07-2026 00:00:00

ISO date

2026-07-01

Day-first date

01-07-2026

Unix seconds

1782864000

Fractional Unix seconds

1782864000.5

timezone

string

IANA timezone used for bucket boundaries and datetime strings without an offset. Missing, empty or unknown names use the deployment timezone (UTC by default).

Examples

UTC

UTC

user_id

string format: uuid

Restrict results to the current account or an accessible sub-user.

Examples

User

550e8400-e29b-41d4-a716-446655440001

Header Parameters

Accept-Language

string

default: en

Preferred language for human-readable API errors. Supported languages: en, ru, uk, de, it, fr, es. Regional language tags and quality weights are accepted; unsupported or omitted values use English.

Examples

de

fr-CA, fr;q=0.9, en;q=0.5

Responses

200

The operation completed successfully.

application/json

object

next

required

string format: uri

nullable

previous

required

string format: uri

nullable

timezone

required

string

start

required

string format: date-time

end

required

string format: date-time

results

required

Array<object>

object

hostname

required

string

requests

required

integer

data

required

integer

Examples

TopDomains

Top domains

{
  "next": null,
  "previous": null,
  "timezone": "UTC",
  "start": "2026-07-01T00:00:00Z",
  "end": "2026-07-02T00:00:00Z",
  "results": [
    {
      "hostname": "example.com",
      "requests": 1240,
      "data": 73400320
    }
  ]
}

400

The request is malformed or violates a business rule.

application/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object

detail

string

non_field_errors

Array<string>

key

additional properties

One of:

string
Array<string>

string

Examples

ValidationError

Validation error

{
  "non_field_errors": [
    "The request could not be processed."
  ]
}

Headers

Content-Language

string

Language used for human-readable errors.

401

Authentication credentials are missing, expired, or invalid.

application/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object

detail

string

non_field_errors

Array<string>

key

additional properties

One of:

string
Array<string>

string

Examples

AuthenticationRequired

Authentication required

{
  "detail": "Authentication credentials were not provided."
}

Headers

Content-Language

string

Language used for human-readable errors.

403

The authenticated account cannot perform this operation.

application/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object

detail

string

non_field_errors

Array<string>

key

additional properties

One of:

string
Array<string>

string

Examples

PermissionDenied

Permission denied

{
  "detail": "You do not have permission to perform this action."
}

Headers

Content-Language

string

Language used for human-readable errors.

500

The service could not complete the operation.

application/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object

detail

string

non_field_errors

Array<string>

key

additional properties

One of:

string
Array<string>

string

Examples

InternalServiceError

Internal service error

{
  "non_field_errors": [
    "Internal server error."
  ]
}

Headers

Content-Language

string

Language used for human-readable errors.