Ploid documentation
Build people-research agents, structured enrichment workflows, and production search systems with Ploid.
Ploid gives software and AI agents one evidence-backed surface for people search, identity resolution, company research, and enrichment.
Quick start
Make your first authenticated request and choose the right Ploid surface.
API
Integrate the Search, Datasets, Profiles, Contacts, and Monitors APIs.
CLI
Research, search, and enrich directly from your terminal.
MCP
Connect Ploid to ChatGPT, Claude, and other remote MCP clients.
Start with a person
POST /v1/person returns a reviewed, evidence-backed report for one person. Identify the person with a LinkedIn URL, a Ploid person_id, or a name plus company domain.
curl https://api.ploid.com/v1/person \
-H "Authorization: Bearer $PLOID_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"identifier": { "linkedin_url": "https://www.linkedin.com/in/example" }
}'A reviewed snapshot returns immediately. Fresh research returns a durable run to poll; see Person for the response and usage contract.
Core surfaces
| Surface | Best for |
|---|---|
| Search API | Find people with a single query (up to 150 results, synchronous) |
| Datasets API | Build curated lists of people from your criteria (preview) |
| Profiles API | Pull full public profiles from social sites |
| Contacts API | Find work emails, personal emails, and phone numbers |
| Monitors API | Get notified when people or lists change |
| Person API | Evidence-backed research on one identified person |
| CLI | Human and scripted terminal workflows |
| MCP | Native tools inside ChatGPT, Claude, and other agent clients |
Production endpoints
- API base URL:
https://api.ploid.com/v1 - OpenAPI document:
https://api.ploid.com/v1/openapi.json - Web app:
https://app.ploid.com - MCP server:
https://api.ploid.com/mcp
Evidence over guesses
Person research separates confirmed facts from inference and returns source URLs and field-level provenance for externally verifiable claims. Search results
are retrieval matches, not verified claims, until POST /v1/person returns evidence.