Skip to content

List proxy request activity

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

Returns recent proxy requests with traffic, endpoint, location, protocol, package, and sticky-session details.

city
string

Normalized city targeting code. country and region are required.

Examples
ExampleLosAngeles

Los Angeles

los_angeles
country
string

Lowercase ISO 3166-1 alpha-2 country code.

Examples
ExampleUnitedStates

United States

us
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
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
ledger_id
string format: uuid

Restrict results to one data ledger when supported.

Examples
ExampleLedger
550e8400-e29b-41d4-a716-446655440005
limit
integer

Maximum records returned on this page.

offset
integer

Zero-based number of matching records to skip.

package_id
string format: uuid

Restrict results to one purchased package.

Examples
ExamplePackage
550e8400-e29b-41d4-a716-446655440002
protocol
string
Allowed values: http socks5

Proxy protocol: http or socks5.

region
string

Normalized region targeting code. country is required.

Examples
ExampleCalifornia
california
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
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
ExampleUTC
UTC
user_id
string format: uuid

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

Examples
ExampleUser
550e8400-e29b-41d4-a716-446655440001
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

The operation completed successfully.

Media typeapplication/json
object
count
required
integer
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
id
required
integer
established_connections
required
integer
reseller_id
required
string
user_id
required
string
package_id
required
string
ledger_id
required
string
username
required
string
user_ip
required
string
server_ip
required
string
data
required
integer
hostname
required
string
protocol
required
string
method
required
string
pool
required
string
is_session
required
boolean
country
required
string
region
required
string
city
required
string
asn
required
string
timestamp
required
string format: date-time
nullable
Examples
ExampleProxyActivity

Proxy activity

{
"count": 42,
"next": "https://api.proxyrequest.com/api/v1/analytics/feed?limit=1&offset=1",
"previous": null,
"timezone": "UTC",
"start": "2026-07-01T00:00:00Z",
"end": "2026-07-02T00:00:00Z",
"results": [
{
"id": 987654,
"established_connections": 2,
"reseller_id": "",
"user_id": "550e8400-e29b-41d4-a716-446655440001",
"package_id": "550e8400-e29b-41d4-a716-446655440002",
"ledger_id": "550e8400-e29b-41d4-a716-446655440005",
"username": "developer",
"user_ip": "198.51.100.25",
"server_ip": "203.0.113.10",
"data": 1048576,
"hostname": "example.com",
"protocol": "http",
"method": "GET",
"pool": "residential",
"is_session": true,
"country": "us",
"region": "california",
"city": "los_angeles",
"asn": "15169",
"timestamp": "2026-07-01T12:30:00Z"
}
]
}

The request is malformed or violates a business rule.

Media typeapplication/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
Examples
ExampleValidationError

Validation error

{
"non_field_errors": [
"The request could not be processed."
]
}
Content-Language
string

Language used for human-readable errors.

Authentication credentials are missing, expired, or invalid.

Media typeapplication/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
Examples
ExampleAuthenticationRequired

Authentication required

{
"detail": "Authentication credentials were not provided."
}
Content-Language
string

Language used for human-readable errors.

The authenticated account cannot perform this operation.

Media typeapplication/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
Examples
ExamplePermissionDenied

Permission denied

{
"detail": "You do not have permission to perform this action."
}
Content-Language
string

Language used for human-readable errors.

The service could not complete the operation.

Media typeapplication/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
Examples
ExampleInternalServiceError

Internal service error

{
"non_field_errors": [
"Internal server error."
]
}
Content-Language
string

Language used for human-readable errors.