API
Search
Run fast synchronous people retrieval with optional title, company, and location filters.
Fast synchronous search
POST /v1/searchUse this endpoint for a one-shot list of up to 100 people.
curl https://api.ploid.com/v1/search \
-H "Authorization: Bearer $PLOID_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "software engineers at fintech companies in San Francisco",
"type": "auto",
"category": "people",
"num_results": 25,
"filters": {
"title": "software engineer",
"location": "San Francisco"
},
"contents": {
"fields": ["linkedin", "title", "company", "location"]
}
}'Search types:
instant— retrieve quickly.auto— retrieve and rerank.deep— apply a deeper grading path.
Choosing a public surface
| Need | Choose |
|---|---|
| Immediate list, 100 or fewer results | /v1/search |
| Multi-step analysis and synthesis | /v1/agent |
Durable People Sets are a private preview and are not currently available to public API keys.
Errors and limits
| Condition | Status and code |
|---|---|
Category is not people | 422 unsupported_category |
| Fast search is not configured | 503 search_unavailable |
| Search timed out without results | 503 search_timeout |
| Search failed without results | 503 search_failed |
POST /v1/search accepts at most 100 results and is capped at 30 requests per minute and 300 per hour, in addition to the organization and API-key buckets. A timeout can return partial results with meta.warning: "search_timeout"; do not discard those results automatically. See Errors & rate limits.