Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.fingerprint.com/llms.txt

Use this file to discover all available pages before exploring further.

Feature in Public PreviewThis feature is currently in a Public Preview testing phase. All feedback is welcome! If you encounter any issues, please contact our support team.
The API detects automation tools like AI Agents, AI Assistants, and AI Browsers. Additionally, it provides IP intelligence like geolocation and data center detection. Automation Intelligence is derived from HTTP request metadata that reaches your server. It does not require the use of a Javascript agent to collect browser context. The API is fast, with average response times of less than 30ms, making it a great fit for edge, pre-origin or middleware contexts. The API is platform-agnostic and can be used with different CDN providers, cloud platforms, or any server backend. If you are a Cloudflare user, consider using Flow.

​
Regions

The Automation Intelligence API is available in the Global, EU and Asia (Mumbai) regions:
RegionBase URLServer Location
Globalhttps://api.fpjs.ioGlobal
EUhttps://eu.api.fpjs.ioFrankfurt, Germany
Asia (Mumbai)https://ap.api.fpjs.ioMumbai, India
Use the Base URL dropdown in the right column of the endpoint to select the correct base URL according to your workspace region.

​
Authentication

Use an Authorization: Bearer header to authenticate to the API. All unauthenticated requests will return a HTTP 403 Forbidden response.

​
Authorization: Bearer HTTP header

When making an API request, add the Authorization: Bearer SECRET_API_KEY HTTP header with your secret API key.

​
Rate limiting

If you exceed the rate limit when making an API call, you’ll get an HTTP 429 error:
JSON
{
  "error": {
    "code": "too_many_requests",
    "message": "too many requests"
  }
}
Retry the request after a short interval. The response may include a Retry-After header indicating how long to wait.

​
Trying it out

You can try calling the Automation Intelligence API directly from this reference:
  1. You are going to need a Secret API Key. You can create one in your Fingerprint Dashboard > API Keys.
  2. Select the Collect Intelligence endpoint.
  3. Click Try it.
  4. Set Authentication to your secret API key.
  5. Enter a URL, some example Headers, an HTTP Method, and an IP address.
  6. Make sure the Base URL corresponds to your workspace region.
  7. Click Send!
A real API response will appear in the Response section. Alternatively, you can view the prepared response examples there. You can also point an API client like Postman to the OpenAPI Schema directly.