Proxy Checker API

by APIGridSecurityUpdated N/A

0.0(0 reviews)

0 / month

Monthly Requests

N/A

Avg Latency

99.99%

Uptime SLA

Endpoints

About this API

Proxy Checker API Documentation

Proxy Checker API provides an advanced proxy detection service to identify proxies, VPNs, TOR nodes, and data-center IPs in real time. This API enables developers to perform real-time proxy checks and real-time IP verification to protect their services from fraud and abuse by detecting masking technologies such as VPNs, proxies, and TOR exit nodes. It is an essential fraud prevention API and fraud detection API for businesses seeking to enhance fraud and abuse protection with IP reputation service capabilities.

Official Website: APIGrid
APIGrid Marketplace Listing: Proxy Checker API on APIGrid

Getting Started

The Proxy Checker API offers two main endpoints:

Free Validation Endpoint (/v1/proxy-checker/validate): Provides a free proxy validation flow that checks connectivity, egress IP, and basic IP intelligence.
Premium Deep-Check Endpoint (/v1/proxy-checker/check): Provides a premium, advanced proxy and VPN detection service with deep target checks including Google, IPInfo, IPQualityScore, Cloudflare Turnstile, and reCAPTCHA v3.

Both endpoints support HTTP, HTTPS, SOCKS4, and SOCKS5 proxy protocols and ephemeral username/password authentication with redacted logging.

Authentication

All requests require an API key passed in the Authorization header as a Bearer token:

Authorization: Bearer YOUR_API_KEY

Replace YOUR_API_KEY with your actual API key.

API Endpoints Reference

1. Free Proxy Validation Endpoint

POST /v1/proxy-checker/validate

This endpoint performs a free proxy validation by checking connectivity, ipify egress IP, and APIGrid IP intelligence. It returns placeholders for premium target results with a message indicating that premium checks require an account balance.

Request Parameters

Parameter	Type	Required	Description
`host`	string	Yes	Proxy hostname or IP address.
`port`	integer	Yes	Proxy port (1 to 65535).
`username`	string	No	Optional proxy username (must be paired with password).
`password`	string	No	Optional proxy password (must be paired with username). Request logs redact this field.
`timeoutMs`	integer	No	Optional timeout per request in milliseconds. Defaults to 30000 (30 seconds).

Sample Request

curl -X POST "https://api.apigrid.net/v1/proxy-checker/validate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "host": "proxy.example.net",
    "port": 8080,
    "username": "demo-user",
    "password": "demo-pass",
    "timeoutMs": 30000
  }'

Sample Response

{
  "alive": true,
  "latencyMs": 812,
  "authAccepted": true,
  "recommendation": "usable",
  "recommendationReason": "Proxy connectivity check succeeded.",
  "totalLatencyMs": 0,
  "proxy": {
    "protocol": "http",
    "detectedProtocol": "http",
    "host": "proxy.example.net",
    "port": 8080,
    "username": "demo-user",
    "hasAuth": true
  },
  "egress": {
    "ip": "198.51.100.44",
    "rdns": [
      "edge-proxy.example.net"
    ],
    "countryCode": "US",
    "countryName": "United States",
    "city": "Ashburn",
    "asNumber": 14618,
    "asName": "AMAZON-AES",
    "asDomain": "amazon.com",
    "organization": "Amazon.com, Inc.",
    "isp": "Amazon.com, Inc.",
    "linkType": "hosting",
    "usageType": "hosting",
    "isProxy": true,
    "proxyType": "proxy",
    "isTor": false,
    "threatLevel": "Medium"
  },
  "targetSummary": {},
  "targetResults": [
    {
      "target": "google_search",
      "methodUsed": "browser",
      "reachable": false,
      "verdict": "indeterminate",
      "httpStatus": null,
      "finalUrl": "https://www.google.com/search?q=example.com",
      "latencyMs": null,
      "error": "Requires balance in your account",
      "signals": {}
    }
  ],
  "riskFlags": []
}

2. Premium Deep-Check Endpoint

POST /v1/proxy-checker/check

This endpoint runs a premium deep-check with the default target set including Google Search, IPInfo lookup, IPQualityScore lookup, Cloudflare Turnstile, reCAPTCHA v3, and Cloudflare Challenge. It supports real-time detection of data-center IPs, VPN and proxy identification, TOR exit node detection, and masking technology detection for enhanced fraud and abuse prevention.

Request Parameters

Parameter	Type	Required	Description
`host`	string	Yes	Proxy hostname or IP address.
`port`	integer	Yes	Proxy port (1 to 65535).
`username`	string	No	Optional proxy username (must be paired with password).
`password`	string	No	Optional proxy password (must be paired with username). Request logs redact this field.
`targets`	string[]	No	Optional premium override targets. Supported values: `google-search`, `ipinfo.io`, `ipqualityscore.com`, `cloudflare-turnstile`, `recaptcha-v3`, `cloudflare-challenge`. Defaults to all six.
`timeoutMs`	integer	No	Optional timeout per request in milliseconds. Defaults to 30000 (30 seconds).

Sample Request

curl -X POST "https://api.apigrid.net/v1/proxy-checker/check" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "host": "proxy.example.net",
    "port": 8080,
    "username": "demo-user",
    "password": "demo-pass",
    "targets": [
      "google-search",
      "ipinfo.io",
      "ipqualityscore.com",
      "cloudflare-turnstile",
      "recaptcha-v3",
      "cloudflare-challenge"
    ],
    "timeoutMs": 30000
  }'

Sample Response

The response structure is similar to the /validate endpoint but includes detailed results from the premium target checks, providing comprehensive real-time proxy and VPN identification, TOR exit node detection, and data-center IP blocking insights.

Response Field Descriptions

Field	Type	Description
`alive`	boolean	Indicates if the proxy is alive and reachable.
`latencyMs`	integer	Latency in milliseconds for the proxy connectivity check.
`authAccepted`	boolean	Whether the proxy authentication was accepted.
`recommendation`	string	Overall recommendation for proxy usability (e.g., "usable").
`recommendationReason`	string	Explanation for the recommendation.
`totalLatencyMs`	integer	Total latency including all checks.
`proxy`	object	Details about the proxy, including protocol, host, port, username, and authentication status.
`egress`	object	Egress IP details including IP address, reverse DNS, geolocation, ASN, ISP, and threat level.
`targetSummary`	object	Summary of premium target checks results.
`targetResults`	array	Detailed results for each premium target check, including verdicts and errors.
`riskFlags`	array	List of risk flags detected during analysis.

Code Examples

cURL Example: Free Proxy Validation

curl -X POST "https://api.apigrid.net/v1/proxy-checker/validate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "host": "proxy.example.net",
    "port": 8080,
    "username": "demo-user",
    "password": "demo-pass",
    "timeoutMs": 30000
  }'

Node.js Example: Premium Deep Check

const response = await fetch("https://api.apigrid.net/v1/proxy-checker/check", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer YOUR_API_KEY",
  },
  body: JSON.stringify({
    host: "proxy.example.net",
    port: 8080,
    username: "demo-user",
    password: "demo-pass",
    targets: [
      "google-search",
      "ipinfo.io",
      "ipqualityscore.com",
      "cloudflare-turnstile",
      "recaptcha-v3",
      "cloudflare-challenge"
    ],
    timeoutMs: 30000
  }),
});

console.log(await response.json());

Python Example: Premium Deep Check

import requests

response = requests.post(
    "https://api.apigrid.net/v1/proxy-checker/check",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
      "host": "proxy.example.net",
      "port": 8080,
      "username": "demo-user",
      "password": "demo-pass",
      "targets": [
        "google-search",
        "ipinfo.io",
        "ipqualityscore.com",
        "cloudflare-turnstile",
        "recaptcha-v3",
        "cloudflare-challenge"
      ],
      "timeoutMs": 30000
    },
)

print(response.json())

Error Handling

HTTP Status Code	Error Message	Description
400	Invalid proxy definition or target list payload.	The request payload is malformed or missing required fields.
401	Missing or invalid API key.	Authentication failed due to missing or invalid API key.
403	This endpoint requires a balance in your account.	Premium endpoint access denied due to insufficient account balance.
429	Rate limit exceeded. Please try again shortly.	Too many requests; rate limit has been exceeded.
500	Internal server error. Please try again later.	Server encountered an unexpected error.

Rate Limits

Plan	Requests Allowed	Period
Starter	60 requests	per minute
Growth	300 requests	per minute

Best Practices

Use the free validation endpoint for initial proxy IP detection and connectivity checks.
Upgrade to the premium deep-check endpoint for comprehensive real-time proxy detection, VPN detection, TOR node detection, and data-center IP detection.
Regularly monitor your API usage to avoid hitting rate limits and ensure smooth fraud and abuse prevention.
Use the timeoutMs parameter to customize request timeouts based on your application's latency requirements.
Always secure your API key and avoid exposing it in client-side code.
Leverage the detailed egress and targetResults data to implement advanced fraud prevention workflows, including VPN blocker and data center IP filter logic.
Combine Proxy Checker API results with your existing IP reputation service for enhanced real-time IP analysis and anonymous IP detection.

Frequently Asked Questions (FAQ)

How to detect if an IP is a proxy or VPN?

Use the /v1/proxy-checker/check endpoint to perform a real-time proxy and VPN identification check. The API returns detailed information about whether the IP is a proxy, VPN, or TOR node, including threat level and usage type.

Can I block VPN users from accessing my website?

Yes. By integrating Proxy Checker API's real-time proxy detection service, you can identify VPN IPs and proxies in real time and implement logic to block or challenge such traffic, effectively acting as a VPN blocker.

How to detect and block data-center IP addresses?

The API provides data-center IP detection with detailed egress.usageType and egress.linkType fields. Use these to identify data-center IPs and apply data center IP blocking or filtering rules.

Does the API detect TOR exit nodes?

Yes. The API includes TOR node detection capabilities and TOR exit node identification to help you block TOR nodes and masked IPs.

What masking technologies does the API detect?

Proxy Checker API detects various masking technologies including proxies, VPNs, TOR exit nodes, and data-center IPs, enabling real-time identification of masking technologies for security and fraud prevention.

How can I prevent fraud using Proxy Checker API?

By integrating Proxy Checker API's real-time proxy detection and VPN and proxy identification features, you can detect anonymizing IPs for security, block fraudulent traffic from VPNs and proxies, and enhance fraud prevention with IP detection.

Protect your services from fraud and abuse with Proxy Checker — the accurate VPN and proxy detection API designed for real-time proxy and VPN identification, TOR exit node detection, and data-center IP filtering.

For more information and to get started, visit APIGrid Proxy Checker API.

Free / 1K

starting price

Subscribe Now Start Free Account

Free lookup endpoints included. 1 premium endpoint unlock on paid access.

Provider

APIGrid

Verified Provider

SDKs

cURL

Statistics

Monthly API calls0 / month

Average latencyN/A

Uptime SLA99.99%

Endpoints2

Last updatedN/A

Back to Directory