API Credentials |

Person Discover API Playground

Test the Person Discover API with real requests and see complete HTTP request/response details. This playground shows you exactly how the API works so you can implement it in your own code.

Try the API

Request Parameters

Enter keywords to discover relevant people:

🔍

Descriptive Keywords - Best Results

Use specific keywords that describe the people you're looking for. Include profession, industry, skills, or other identifying characteristics. Use the Location field to narrow results to a specific area.

Example: Keywords: "registered nurses" + Location: "California"
Describe the type of people you want to discover (e.g., profession, job title, skills)
Optional: State, city, or region to search in. Leave blank to search all of the US.
Number of results to return (1-100). Default: 50
URL to receive results asynchronously when processing completes

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:

Healthcare Professionals

Discover nurses in a specific state

Keywords: registered nurses
Location: California

Tech Industry

Discover software engineers in a tech hub

Keywords: software engineers
Location: San Francisco, CA

Real Estate

Discover real estate agents in a market

Keywords: real estate agents
Location: Miami, FL

Legal Professionals

Discover lawyers in a metropolitan area

Keywords: lawyers
Location: New York City, NY

Response Format

The API returns a JSON response with the following structure:

{ "success": true, "data": { "request_id": "abc123def456", "status": "completed", "keywords": "registered nurses", "location": "California", "results_count": 50, "results": [ { "displayname": "Jane Smith", "bio": "Registered Nurse at Kaiser Permanente...", "location": "Los Angeles, CA", "altemails": ["jane.smith@email.com"], "fullphone": ["555-123-4567"], "social_profiles": { "facebook": { "url": "https://facebook.com/janesmith123", "username": "janesmith123" } } } ], "completed_on": "2025-09-05T21:45:12", "created_on": "2025-09-05T21:45:06" }, "timestamp": "2025-09-05T21:45:25Z" }

Need Help?

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

Email: support@nyne.ai

Sales: sales@nyne.ai