Bulk Data

Bulk data is available for clients who want to perform large-scale analysis or integrate Synthient data into their own systems. This includes options for data exports, API access, and custom data feeds.

Data Feeds

The feeds are delivered in JSONL or TEXT format which can be fetched on the https://v3v3api.synthient.com domain.

Enterprise customers will also be provided with a direct clickhouse connection to run SQL queries directly on the Synthient database.

GET/v3/feeds

Fetching Feeds

The feeds endpoint allows users to create a full copy of the database or export specific segments of data. This is the equivalent to running a SQL query on the entire dataset.

  • Name
    provider
    Type
    string | null
    Description

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

  • Name
    type
    Type
    string | null
    Description

    The type of anonymization service to filter by. If null, returns all types. Please note it's redudant to provide both provider and type in the same request.

  • Name
    last_seen
    Type
    string | null
    Description

    Filter results to only include IPs last seen on or after this date (YYYY-MM-DD). If null, returns all records regardless of last seen date.

  • Name
    format
    Type
    JSONL | TEXT
    Description

    The format of the returned data. Options are 'JSONL' for JSON Lines format or 'TEXT' for plain text format.

  • Name
    country_CODE
    Type
    string | null
    Description

    Filter results to only include IPs from the specified country code (e.g., 'US', 'DE'). If null, returns all countries.

  • Name
    limit
    Type
    number
    Description

    The maximum number of records to return. Default is all records.

Request

GET/v3/feeds/anonymizers
curl -G https://v3api.synthient.com/v3/feeds/anonymizers \
  -H "Authorization: $API_KEY" \
  --data-urlencode "provider=BIRDPROXIES" \
  --data-urlencode "type=RESIDENTIAL_PROXY" \
  --data-urlencode "last_seen=2025-01-01" \
  --data-urlencode "format=JSONL" \
  --data-urlencode "country_CODE=US" \
  --data-urlencode "limit=1000"

Responses

{"ip":"188.136.74.173","network":{"asn":12355,"isp":"HeLi NET Telekommunikation GmbH & Co. KG","type":"RESIDENTIAL","org":"HeLi NET Telekommunikation GmbH & Co.","abuse_email":null,"abuse_phone":null,"domain":null},"location":{"country":"DE","state":"NW","city":"Hamm","timezone":"Europe/Berlin","longitude":7.78109,"latitude":51.67941,"geo_hash":"u1j"},"ip_data":{"device_count":0,"devices":[],"behavior":[],"categories":["RESIDENTIAL_PROXY"],"ip_risk":96,"enriched":[{"provider":"BIRDPROXIES","type":"RESIDENTIAL_PROXY","last_seen":"2025-08-23"},{"provider":"GOPROXIES","type":"RESIDENTIAL_PROXY","last_seen":"2025-08-08"},{"provider":"INFATICA","type":"RESIDENTIAL_PROXY","last_seen":"2025-08-23"},{"provider":"NETNUT","type":"RESIDENTIAL_PROXY","last_seen":"2025-08-22"},{"provider":"NODEMAVEN","type":"RESIDENTIAL_PROXY","last_seen":"2025-08-21"},{"provider":"OXYLABS","type":"RESIDENTIAL_PROXY","last_seen":"2025-08-23"},{"provider":"PINGPROXIES","type":"RESIDENTIAL_PROXY","last_seen":"2025-04-21"},{"provider":"SOAX","type":"RESIDENTIAL_PROXY","last_seen":"2025-09-13"}]}}
... // 1000 lines

Specifying TEXT Format

When format=TEXT is specified, the response will be a plain text list of IP addresses, one per line. This format is useful for importing into systems that accept plain text input.

The TEXT format does not include any additional metadata or fields, only the IP addresses and the IP addresses are not in CIDR notation.

188.136.74.173
... // 1000 lines