API Reference

Base URL

All API requests are made to:

https://detect.expert/api/v1/

Authentication

Every request must include your API key in the X-Api-Key header:

X-Api-Key: YOUR_API_KEY

Generate your key in the detect.expert dashboard.

APIs Overview

Proxy API

Purchase and manage residential, mobile, and datacenter proxies. Supports auto-renewal, rotating credentials, and order history.

• GET /users/balance/ — check account balance
• GET /proxies/history/ — view ordered proxies
• GET /proxies/shop/ — browse available proxies
• POST /proxies/rotating-credentials/ — generate rotating proxy credentials

Numbers API (SMS)

Book virtual and residential phone numbers to receive SMS verification codes for any service.

• GET /numbers/mixed/countries/ — list supported countries
• GET /numbers/mixed/ — list services by country
• GET /numbers/residential/ — list residential services
• POST /numbers/ — book a number

Checker API

Validate proxies and parse web pages.

• POST /checkers/socks/ — submit SOCKS IPs for checking
• GET /checkers/socks/{id}/ — get checker results
• POST /parse_html/ — detect form fields on a website
• GET /parse_html/{id}/ — retrieve parse results

Rate Limiting

If you exceed the allowed request rate, the API will respond with 429 Too Many Requests. Implement exponential backoff in your client to handle this gracefully.