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, enrichment, and connected-app work.
Quick start
Make your first authenticated request and choose the right Ploid surface.
API
Integrate the Agent, People Sets, search, and enrichment endpoints.
CLI
Research, search, and enrich directly from your terminal.
MCP
Connect Ploid to ChatGPT, Claude, and other remote MCP clients.
Start with the Agent
POST /v1/agent is the highest-level integration surface. Send a natural-language job and let the model choose the right research path.
curl https://api.ploid.com/v1/agent \
-H "Authorization: Bearer $PLOID_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Research Retool, identify its current stage, and return three stage-matched lookalikes with evidence URLs.",
"max_acu": 1.2,
"response_format": "standard"
}'Use ordinary conversational output by default. Add an output_schema only when the calling system needs a validated machine-readable value.
Core surfaces
| Surface | Best for |
|---|---|
| Agent API | Open-ended research, synthesis, source selection, and multi-step work |
| People Sets | Durable, criteria-verified lists with enrichment, SSE, and export |
| Search API | Fast, synchronous people retrieval for up to 100 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
Ploid agents should separate confirmed facts from inference and return source URLs for externally verifiable claims. Ask for that standard explicitly when it matters to your workflow.