# Nyne.ai API Documentation

> Nyne.ai provides people and company data APIs for person enrichment, company enrichment, people search, and more. Every documentation page is available in machine-readable Markdown at the .md URLs below (each also has an HTML twin at the same URL without .md). The full content of every page, concatenated into a single file, is at https://api.nyne.ai/llms-full.txt.

## Get started

- [API Reference index](https://api.nyne.ai/documentation.md): Overview of every API surface, authentication, and the async pattern.
- [Quick Start](https://api.nyne.ai/documentation/quickstart.md): Create an API key, call an endpoint, and poll for the result.
- [Your First Request](https://api.nyne.ai/documentation/first-request.md): Authenticate, submit, poll the same path, and read the response envelope.
- [Authentication](https://api.nyne.ai/documentation/authentication.md): X-API-Key / X-API-Secret headers and rate limits.
- [Async requests, polling & webhooks](https://api.nyne.ai/documentation/async.md): The 202 + request_id + poll model, and callback_url delivery.
- [Constructing effective requests](https://api.nyne.ai/documentation/effective-requests.md): Identifiers, the fields array, shortcuts, and search filters.
- [Choosing request depth](https://api.nyne.ai/documentation/request-depth.md): lookup_mode (fast/balanced/deep) and search type (light/medium/premium).
- [Interpreting responses](https://api.nyne.ai/documentation/responses.md): The envelope, async status, confidence scores, and data provenance.
- [Credits, billing & usage](https://api.nyne.ai/documentation/credits.md): Fixed vs dynamic pricing, feature surcharges, quotas, and usage tracking.
- [Rate limits & error handling](https://api.nyne.ai/documentation/rate-limits.md): The three-tier limiter, quota headers, the error taxonomy, and backoff.
- [Evaluating the APIs](https://api.nyne.ai/documentation/evaluating.md): Benchmark accuracy, coverage, latency, and cost with fair ground truth.

## Person APIs

- [Person APIs overview](https://api.nyne.ai/documentation/person.md): Resolve anyone from any identifier - then enrich, monitor, and analyze them. Search, verified contact data, social intelligence, and AI research over the same person graph.
- [Person Search API](https://api.nyne.ai/documentation/person/search.md): `POST /person/search` - Find people by natural-language query with structured filters.
- [Person Enrichment API](https://api.nyne.ai/documentation/person/enrichment.md): `POST /person/enrichment` - Resolve a full person profile from one or more identifiers.
- [Deep Research API](https://api.nyne.ai/documentation/person/deep-research.md): `POST /person/deep-research` - Run an in-depth autonomous research pass on a person.
- [OSINT Deep Search API](https://api.nyne.ai/documentation/person/osint.md): `POST /person/osint` - Run an agentic OSINT investigation on a person. Disabled by default - access on request.
- [Personal Interests API](https://api.nyne.ai/documentation/person/interests.md): `POST /person/interests` - Infer a person’s interests and affinities.
- [Article Search API](https://api.nyne.ai/documentation/person/articlesearch.md): `POST /person/articlesearch` - Find articles and press mentions for a person.
- [Social Newsfeed API](https://api.nyne.ai/documentation/person/newsfeed.md): `POST /person/newsfeed` - Pull recent social posts from a person’s resolved profiles.
- [Social Interactions API](https://api.nyne.ai/documentation/person/interactions.md): `POST /person/interactions` - Surface a person’s social interactions and engagement.
- [Competitor Engagements API](https://api.nyne.ai/documentation/person/competitor-engagements.md): `POST /person/competitor-engagements` - Detect a person’s engagement with competitor content.
- [Person Events API](https://api.nyne.ai/documentation/person/events.md): `POST /person/events` - Retrieve notable life/career events for a person.
- [Ask API](https://api.nyne.ai/documentation/person/ask.md): `POST /person/ask` - Ask a natural-language question about a person.
- [Leads API](https://api.nyne.ai/documentation/person/leads.md): `POST /person/leads` - Generate qualified lead candidates from a natural-language description.
- [Discover API](https://api.nyne.ai/documentation/person/discover.md): `POST /person/discover` - Discover matching people from keywords and location.
- [Discovery API](https://api.nyne.ai/documentation/person/discovery.md): `POST /person/discovery` - Discover people from the open web with natural-language queries and match conditions.
- [Simulation API](https://api.nyne.ai/documentation/person/simulation.md): `POST /person/simulation` - Predict how a person would respond to a question.
- [Lookup Fields API](https://api.nyne.ai/documentation/person/lookup-fields.md): `POST /person/lookup-fields` - Request specific fields for a person from any identifier.
- [Email Finder API](https://api.nyne.ai/documentation/person/email.md): `POST /person/email` - Find a verified business email for a person.
- [Phone Finder API](https://api.nyne.ai/documentation/person/phone.md): `POST /person/phone` - Find a phone number for a person.
- [Social Lookup API](https://api.nyne.ai/documentation/person/social-lookup.md): `POST /person/social-lookup` - Resolve a profile on a target platform from another identifier.
- [Single Social Lookup API](https://api.nyne.ai/documentation/person/single-social-lookup.md): `POST /person/single-social-lookup` - Resolve a single social profile (alias of social-lookup).
- [Social Account Validator API](https://api.nyne.ai/documentation/person/social-account-validator.md): `POST /person/social-account-validator` - Validate a public social profile or post and capture a screenshot.
- [Social Profiles API](https://api.nyne.ai/documentation/person/social-profiles.md): `POST /person/social-profiles` - Find all social media accounts for a person.

## Company APIs

- [Company APIs overview](https://api.nyne.ai/documentation/company.md): Company intelligence resolved from a domain - firmographics, employees, funding history, buying intent, and product signals.
- [Company Search API](https://api.nyne.ai/documentation/company/search.md): `POST /company/search` - Find companies from a natural-language query.
- [Company Discovery API](https://api.nyne.ai/documentation/company/discovery.md): `POST /company/discovery` - Discover companies from the open web with natural-language queries and match conditions.
- [Company Enrichment API](https://api.nyne.ai/documentation/company/enrichment.md): `POST /company/enrichment` - Resolve a full company profile from a domain, email, phone, or company social URL.
- [Company Employees API](https://api.nyne.ai/documentation/company/employees.md): `POST /company/employees` - Retrieve public employee profiles for a company.
- [Company Intent API](https://api.nyne.ai/documentation/company/intent.md): `POST /company/intent` - Find and rank ICP candidates from demonstrated buying-intent signals.
- [CheckSeller API](https://api.nyne.ai/documentation/company/checkseller.md): `POST /company/checkseller` - Verify whether a company sells a given product or service.
- [CheckFeature API](https://api.nyne.ai/documentation/company/checkfeature.md): `POST /company/checkfeature` - Detect whether a company’s site has a given feature, technology, or capability.
- [Company Funding API](https://api.nyne.ai/documentation/company/funding.md): `POST /company/funding` - Retrieve verified funding-round and acquisition history for a company.
- [Company Funders API](https://api.nyne.ai/documentation/company/funders.md): `POST /company/funders` - Look up an investor / fund profile (partners, thesis, check size, recent deals).
- [Company Needs API](https://api.nyne.ai/documentation/company/needs.md): `POST /company/needs` - Summarize pain points / challenges from a company’s official filings.
- [Competitor Engagements API](https://api.nyne.ai/documentation/company/competitor-engagements.md): `POST /company/competitor-engagements` - Find people who engaged with a company page, with profile URLs and post context.

## Account APIs

- [Account APIs overview](https://api.nyne.ai/documentation/account.md): Account-level monitoring - track credit consumption, monthly allocation, and per-API usage breakdowns.
- [Usage API](https://api.nyne.ai/documentation/account/usage.md): `GET /usage` - Monitor credit consumption, allocation, and per-API breakdown (synchronous, 200).

## MCP

- [Nyne.ai MCP Server](https://api.nyne.ai/documentation/mcp.md): Connect AI assistants to Nyne.ai over the Model Context Protocol.
- [MCP Quick Start](https://api.nyne.ai/documentation/mcp/quickstart.md): Per-client MCP setup in three minutes.