Getting started

API overview

The OSINT Intel APIs return risk intelligence as JSON, so you can check customers, counterparties and payment details inside your own onboarding, payout and monitoring flows. Every endpoint is a single POST with a JSON body.

Base URL

All requests go over HTTPS to:

https://osintintel.com

Data Intelligence has one endpoint per identifier: website, ip-address, email-address, phone-number, iban, card-bin, crypto-wallet.

Authentication

Every customer gets an API key. Send it with each request in the Authorization header as a bearer token. X-API-Key: YOUR_API_KEY works too.

Create a free account, then make keys under Dashboard → API. A key is shown once, so store it right away. Requests are paid from your prepaid credit; top up under Dashboard → Billing. Keep your key on your server; never put it in a browser or app.

Request
curl -X POST "https://osintintel.com/api/ip-address" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ip":"198.51.100.77"}'

Responses

Data Intelligence responses share one envelope: success, cached and the report. Read riskFactors for the signals that were found. Website and IP reports also carry a riskScore from LOW to CRITICAL, with the riskPoints behind it.

Any field can be null when a source had no answer. Build your integration to accept that.

Response
{
  "success": true,
  "cached": false,
  "report": { ... }
}

Caching

Completed reports are cached for up to one month (crypto wallets: 24 hours), so repeat checks are fast and your whole team sees the same evidence. The cached field tells you whether a report came from the cache.

Add "force": true to any body to skip the cache and run a fresh analysis.

Errors

Errors use standard HTTP status codes and return success: false with a readable error message.

  • 400

    Bad request

    The body is not valid JSON, or the value is missing or malformed.

  • 401

    Unauthorized

    The API key is missing or invalid.

  • 402

    Payment required

    Your credit balance is too low for a report. Top up in the dashboard.

  • 422

    Unprocessable

    The target could not be analysed, for example a website that is down, blocks us or timed out.

  • 429

    Too many requests

    You reached your rate limit. Wait for the time in Retry-After.

  • 500

    Server error

    Something went wrong on our side. Retrying later is safe.

Error
{
  "success": false,
  "error": "A valid IP address is required."
}

Rate limits

With your API key you can make 600 Data Intelligence requests per hour. Requests without a key count as free lookups and are limited to one per day. When you reach a limit you get a 429 with X-RateLimit-Remaining, X-RateLimit-Reset and Retry-After headers.

Need more? We raise limits per customer.

Pricing

  • Fresh analysis€0.29 / request
  • Served from cache (cached: true)€0.25 / request

Prices include VAT. Reports are paid from prepaid credit, topped up in your dashboard. Volume pricing is available at scale.