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, person, enrichment, and People Sets endpoints.
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 |
|---|---|
| Person API | Evidence-backed research on one identified person |
| People Sets | Durable, criteria-verified lists (preview) |
| Search API | Fast, synchronous people retrieval for up to 150 results |
| Enrichment API | Resolving known identities and selected contact or social fields |
| 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.