Quick start

Get an API key

Sign in, choose the workspace that should pay (Personal or a team), and open Dashboard → API keys. Create a key and copy the secret now. It is shown only once.

Keys start with ov_ and are hashed at rest. Personal keys bill your wallet; team keys bill the team.

Pick a provider and input type

Every search is a provider + input_type + query. Call GET /v1/providers (no auth) for live input types and prices, or check the pricing matrix. Invalid pairs return HTTP 422 and cost nothing.

curl "https://apiv1.osintverse.com/v1/providers"

Run the search

With the Python SDK:

pip install osintverse

from osintverse import OSINTverse

client = OSINTverse(api_key="ov_your_api_key")
search = client.search.create(
    provider="leakradar",
    input_type="email",
    query="user@example.com",
    wait=True,
)
print(search.status, search.result)

Or over HTTP with x-api-key:

curl -X POST "https://apiv1.osintverse.com/v1/search" \
  -H "Content-Type: application/json" \
  -H "x-api-key: ov_your_api_key" \
  -d '{"provider":"leakradar","input_type":"email","query":"user@example.com"}'

Most providers return status: "completed" with results in the create response. FaceCheck image searches and OSINT Industries lookups return running. Poll until they finish, or pass wait=True in the SDK. OSINT Industries result.matches grows as modules finish.