API Credentials |

Person Discovery API Playground

Test the Person Discovery API with real requests. Find people from the open web using natural language queries with structured matching, source citations, and optional enrichment.

Credit Cost: Each discovery request costs 10 credits. Make sure you have sufficient credits before submitting.

Try the API

Request Parameters

Discover People from the Web

Use natural language to find people matching your criteria. Get structured results with match evaluations, source citations, and optional data extraction.

Natural language description of the people you want to find (max 2000 characters)
Structured conditions each result must match
Additional data to extract for each matched result
Number of results (5-100, default 10)
Quality tier affects depth and accuracy of results
People to exclude from results
HTTPS URL to receive results asynchronously

Quick Examples

Click any example to populate the form:

Response

Send a request to see the complete HTTP request/response details here...

Or Check Existing Request

Paste a request ID from a previous request to check its status:

Example Requests

Here are some example requests you can try:

AI Researchers

Find NLP researchers with publications

Query: AI researchers specializing in NLP

Sales Leaders

Find VP Sales at B2B SaaS companies

Query: VP of Sales at B2B SaaS
Requirements: 10+ years experience

With Extraction

Find founders with enrichment data

Query: Startup founders in fintech
Extract: LinkedIn URL, company funding

Response Format

The API returns discovery results with matched people, evaluations, source citations, and optional extracted data:

{ "success": true, "data": { "request_id": "a1b2c3d4...", "status": "completed", "completed": true, "result": { "entity_type": "people", "query": "AI researchers in NLP...", "results_count": 10, "results": [ { "name": "Dr. Jane Smith", "url": "janesmith.ai", "description": "NLP researcher at Stanford...", "match_status": "matched", "evaluations": { "published_papers": {"value": "yes", "matched": true} }, "sources": [...] } ], "metrics": { "candidates_evaluated": 50, "candidates_matched": 10 } }, "completed_on": "2026-02-19T10:35:00" }, "timestamp": "2026-02-19T10:35:00Z" }

Need Help?

Our support team is here to help you integrate and use our APIs effectively.

Email: support@nyne.ai

Sales: sales@nyne.ai