# Clodo API documentation

> People discovery, contact enrichment, and personalized outreach.

## Get Started

- [Welcome to Clodo](https://docs.clodo.ai/introduction.md): People discovery, contact enrichment, and personalized outreach. One API for your apps and agents.
- [Get an API Key](https://docs.clodo.ai/get-api-key.md): Create a Clodo account and generate your API key.
- [Make your first API call](https://docs.clodo.ai/api-quick-start.md): Go from your API key to your first enrichment response.
- [Credits & Pricing](https://docs.clodo.ai/guides/credits-and-pricing.md): Understand how Clodo credits work, what each endpoint costs, and how to manage your balance.

## API Essentials

- [Authentication](https://docs.clodo.ai/api-reference/authentication.md): Authenticate your requests and manage your API keys.
- [API Base URL](https://docs.clodo.ai/api-reference/base-url.md): The base URL, endpoint paths, and conventions for the Clodo API.

## Search API

- [Agentic Search](https://docs.clodo.ai/api-reference/endpoint/agentic-search.md): The canonical agentic people search endpoint. Describe the people you want to find in as much detail as you like—their role, background, expertise, company, or specific experiences. Clodo searches and researches potential matches, returning people with evidence explaining why they fit your criteria.
- [People Search](https://docs.clodo.ai/api-reference/endpoint/people-search.md): Find sales leads, source candidates, and discover industry experts with a natural-language people search. Describe your target audience and retrieve matching professional profiles.
- [Deep Search](https://docs.clodo.ai/api-reference/endpoint/deep-search.md): Find and qualify sales prospects, candidates, and subject-matter experts against detailed criteria. Turn a targeted people search into a researched shortlist with professional context and fit scores.

## Enrichment API

- [Email Enrichment](https://docs.clodo.ai/api-reference/endpoint/email-enrichment.md): Find a professional email address from a profile URL or a name and company domain.
- [Phone Enrichment](https://docs.clodo.ai/api-reference/endpoint/phone-enrichment.md): Find a person’s phone number from their professional identity.
- [Professional URL](https://docs.clodo.ai/api-reference/endpoint/professional-url.md): Resolve a person’s identity to a professional profile URL.
- [Professional Profile](https://docs.clodo.ai/api-reference/endpoint/professional-profile.md): Retrieve a person’s work history, education, and current role from their profile URL.

## Outreach API

- [Outreach Emails](https://docs.clodo.ai/api-reference/endpoint/outreach-emails.md): Draft personalized emails, review them, and send from your connected inbox.
- [Sequences](https://docs.clodo.ai/api-reference/endpoint/sequences.md): Create, review, and run personalized email sequences with automatic follow-ups.
- [Sending Accounts](https://docs.clodo.ai/api-reference/endpoint/sending-accounts.md): Check your connected mailboxes before creating outreach emails or sequences.

## Webhooks

- [Signing Secrets](https://docs.clodo.ai/guides/webhook-secrets.md): Create and manage the signing secrets used to authenticate webhook deliveries.
- [Signature Verification](https://docs.clodo.ai/guides/webhook-signing.md): Verify that a webhook came from Clodo before processing its payload.
- [Webhook Events](https://docs.clodo.ai/guides/webhook-events.md): Reference payloads for search and enrichment completion and failure events.
- [Retry Policy](https://docs.clodo.ai/guides/webhook-retries.md): Understand delivery attempts, acknowledgements, and duplicate events.

## Guides

- [People Search API Use Cases](https://docs.clodo.ai/guides/use-cases.md): Build B2B lead generation, candidate sourcing, and expert discovery workflows with Clodo. Compare search endpoints and connect research, enrichment, and outreach.
- [GTM Lead Generation](https://docs.clodo.ai/guides/gtm-lead-generation.md): Learn how to find B2B sales leads with an API: turn your ICP into a prospect list, qualify decision-makers, enrich email addresses, and prepare personalized outreach.
- [Recruiting & Candidate Sourcing](https://docs.clodo.ai/guides/recruiting-candidate-sourcing.md): Source candidates from a job description with the Clodo API. Research professional experience, build recruiting shortlists, enrich profiles, and draft recruiter outreach.
- [Expert Discovery](https://docs.clodo.ai/guides/expert-discovery.md): Find subject-matter experts for industry interviews, customer research, and advisory projects. Search by first-hand experience, review evidence, and prepare invitations.
- [Async Polling](https://docs.clodo.ai/guides/async-polling.md): Retrieve the status and results of asynchronous jobs.
- [Idempotency](https://docs.clodo.ai/guides/idempotency.md): Retry asynchronous requests without creating duplicate jobs.

## Troubleshooting

- [Handling Errors](https://docs.clodo.ai/api-reference/errors.md): Understand error responses and decide when to retry.
- [Rate Limits](https://docs.clodo.ai/api-reference/rate-limits.md): Plan your request throughput and handle rate limiting.