Nyne Nyne API Login
API Reference

Nyne API

Programmatic access to person & company enrichment and search. Every endpoint is documented with parameters, responses, credit costs, and copy-paste code samples in cURL, Python, Node, and PHP.

Discover the API

Person and company enrichment, search, and an MCP server for agents - pick where you want to start.

Authentication

The Person and Company APIs authenticate with an API key + secret sent as HTTP headers (X-API-Key · X-API-Secret). See the Authentication guide for details.

Keep secrets server-side
Never ship your API secret to the browser. Generate keys from your dashboard and call the API from your backend. Rate limits apply: 100/min, 1,000/hour.
Async pattern

Most enrichment and search endpoints are asynchronous. You submit a request and receive 202 Accepted with a request_id, then poll the matching status endpoint until the job is completed. Optionally provide a callback_url to receive the result via webhook instead of polling.

# 1. Submit - returns 202 + a request_id
curl -X POST https://api.nyne.ai/person/enrichment \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET" \
  -d '{ "email": "[email protected]" }'
# => { "request_id": "…", "status": "queued" }

# 2. Poll the same path - until status is "completed"
curl https://api.nyne.ai/person/enrichment?request_id=…
Credits are charged on results
Empty results never burn credits. Cache hits are charged at the full bucket rate.
For AI agents

Machine-readable entry points for agents and tooling. A flat index, a structured manifest, and an MCP server quickstart.