Firehose

Some clients may require a real-time stream of all IP address activity in the Synthient database. The firehose endpoint provides a continuous stream of IP address data as it is added or updated in the database.

WSS/v3/stream

Firehose Endpoint

The firehose endpoint is a WebSocket connection that streams real-time updates of IP address activity. Each message contains information about an IP address, including its provider, type, and the timestamp when it was seen as active.

  • Name
    provider
    Type
    string
    Description

    The name of the provider to filter by. If null, returns all providers.

  • Name
    ip
    Type
    string
    Description

    The ip address to filter by. If null, returns all IPs.

  • Name
    type
    Type
    string
    Description

    The type of anonymization service.

  • Name
    timestamp
    Type
    uint32
    Description

    The UNIX timestamp when the IP was seen as active.

Request

WSS/v3/stream
wss://v3api.synthient.com/v3/feeds/anonymizers \
  -H "Authorization: $API_KEY"

Responses

{"ip":"188.136.74.173","provider":"BIRDPROXIES","type":"RESIDENTIAL_PROXY","timestamp":1758627726}
...