API Credentials |

Person Search API Playground

Test the Person Search 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

Search Parameters

Describe who you're looking for using natural language:

Describe who you're looking for in plain English (required)
Trade-off between speed and quality. Light is fastest but less thorough, Premium provides the most comprehensive results.
Maximum number of results to return (default: 10). API supports up to 1000.
Use next_cursor from previous response to fetch the next page of results
Or use request_id with offset to jump to specific positions
Starting position (0-indexed). Combined with limit cannot exceed 1000.
Show: Include contact data in results. Require: Only return profiles with contact data.
Insights/Scoring: AI-powered analysis. High Freshness: Prioritize recent profiles. Not available for Light type.
Location & Language Filters
Professional Filters
Education Filters
Experience Range Filters
Social & Demographics Filters
Name & Gender Filters
Experience Type Filters
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...

Example Requests

Here are some example natural language queries you can try:

Company Search

Find contacts at a specific company

Query: "Software engineers at Microsoft in Seattle"

Role Search

Find contacts with a specific job title

Query: "Marketing directors at Fortune 500 companies"

Startup Search

Find people at startups

Query: "Product managers at Series B startups in NYC"

Education Search

Find alumni of specific schools

Query: "Startup founders who attended Stanford"

Response Format

The API returns a JSON response with the following structure:

{ "success": true, "data": { "request_id": "abc12345_1737123456_1234", "status": "completed", "results": [ { "displayname": "John Smith", "headline": "Senior Software Engineer", "bio": "Experienced engineer with expertise in cloud technologies.", "location": "Seattle, WA", "best_business_email": "john.smith@microsoft.com", "altemails": ["john.smith@microsoft.com"], "fullphone": [{"fullphone": "+1-555-123-4567", "phone_type": "mobile"}], "social_profiles": { "linkedin": { "url": "https://www.linkedin.com/in/johnsmith", "username": "johnsmith" } }, "organizations": [ { "name": "Microsoft", "title": "Senior Software Engineer", "startDate": "2020-01" } ], "score": 0.95, "insights": { "overall_summary": "Highly relevant match for your search criteria" } } ], "total_results": 25, "limit": 10 }, "timestamp": "2025-09-05T21:45:25Z" }

Pagination

To get more results, use the next_cursor from the response in your next request. Each request returns just the requested page of results. Cached results are served for free.

Need Help?

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

Email: support@nyne.com

Sales: sales@nyne.ai

Try EZ Tool for a simpler, no-code interface.