Proxy detection database documentation

How to download the proxy detection database

Business and reseller plans can download the proxy detection database in CSV and mmdb formats. The database is updated every 3 hours to ensure you have access to the most recent proxy information.

Download URL Format

https://deviceandbrowserinfo.com/proxy-api/downloads/ips_<number_of_days>_days.<file_extension>?api_key=<your_api_key>

URL Parameters

The download URL requires the following parameters:
• <number_of_days>: Choose from available time ranges: 30 days (full database), 7 days, or 3 days. Reseller plans have access to all ranges. Business plans only have access to the last 3 days of data.
• <file_extension>: Select your preferred format: csv for spreadsheet applications or mmdb for MaxMind database compatibility.
• <your_api_key>: Your unique API key, available in your dashboard after logging in.

Example

To download the full 30-day database in CSV format, use:

https://deviceandbrowserinfo.com/proxy-api/downloads/ips_30_days.csv?api_key=<your_api_key>

Format Details

• CSV Format: Standard comma-separated values format. Each row represents a proxy entry with all available fields. Ideal for data processing pipelines and custom integrations.
• MMDB Format: MaxMind's binary database format. Optimized for high-performance lookups and compatible with MaxMind's database reader libraries. Recommended for fast IP lookups.

Database fields description

The database contains the following fields:

  • ip: The IP address of the detected proxy server.
  • asn.asn: The Autonomous System Number (ASN) related to the proxy IP address.
  • asn.name: The name of the organization that owns the ASN (e.g., "Amazon.com", "DigitalOcean").
  • asn.network: The network range in CIDR notation that contains the proxy IP address (e.g., "192.168.1.0/24").
  • geo.countryCode: The ISO country code of the proxy IP address (e.g., "US", "FR").
  • isDataCenter: A boolean flag indicating whether the IP address belongs to a known data center or cloud provider infrastructure.
  • proxyType: The classification of the proxy server based on its infrastructure and usage patterns:
    • "data_center": Proxy servers hosted in data centers or cloud infrastructure
    • "residential": Proxies using residential IP addresses from home internet connections
    • "isp": Proxies registered under the name of an Internet Service Provider but located in a data center.
    • "tor": IPs associated with a Tor exit node.
    • "unknown": IPs with insufficient data to determine the proxy type
  • lastSource: The proxy provider or platform through which we last observed this IP address. Note that a proxy IP may be available through multiple providers simultaneously - we only track the most recent provider.
  • lastSeenAt: The timestamp (in ISO 8601 format) of when this IP was last confirmed to be operating as a proxy.