# LeadGenius

> LeadGenius provides precision B2B contact and account intelligence for go-to-market teams,
> combining machine learning with a global team of human researchers to build custom datasets.
> The LeadGenius Enrichment API is a RESTful, API-key authenticated service for company enrichment,
> contact enrichment and contact append — offered both as asynchronous Campaigns (batch upload,
> webhook on finalization, retrieve) and as real-time "rapid enrichment" requests.

Note: LeadGenius publishes a file at https://www.leadgenius.com/llms.txt, but its contents are
robots.txt-style crawl directives rather than the llms.txt format. This file was generated by the
API Evangelist enrichment pipeline from apis.yml and the artifacts in this repository.

## APIs

- [LeadGenius Enrichment API](https://docs.leadgenius.com/): Account and contact enrichment, contact append, exclusion lists and real-time rapid enrichment. Base URL https://leadgenius.com, all paths under /api/v1/.

## Specs

- [OpenAPI 3.1 (captured)](openapi/leadgenius-enrichment-api-openapi.yml): 11 operations plus the record-finalized webhook, transcribed from the published reference.
- [Overlay](overlays/leadgenius-enrichment-api-overlay.yaml): API Evangelist enhancements over the captured spec.
- [Webhook catalog](asyncapi/leadgenius-enrichment-webhooks.yml): the record.finalized callback.

## Operations

- createCampaign — POST /api/v1/enrichment/campaigns/
- getUploadRequestSample — GET /api/v1/enrichment/upload/{slug}/
- uploadRecordsToCampaign — POST /api/v1/enrichment/upload/{slug}/
- updateCampaign — PATCH /api/v1/enrichment/update/{slug}/
- retrieveCampaignRecords — GET /api/v1/enrichment/retrieve/{slug}/
- getApiUsageStats — GET /api/v1/enrichment/status/
- uploadExclusionRecords — POST /api/v1/exclusion/upload/
- createRapidEnrichmentRequest — POST /api/v1/enrichment/rapid/
- listEnrichmentRequests — GET /api/v1/enrichment/rapid/
- retrieveEnrichedRecord — GET /api/v1/enrichment/rapid/{id}/
- getEnrichmentStats — GET /api/v1/enrichment/rapid/stats/

## Docs

- [API Reference](https://docs.leadgenius.com/)
- [Authentication](https://docs.leadgenius.com/#authentication): `Authorization: Token {apikey}`
- [Rate Limits](https://docs.leadgenius.com/#rate-limits): 50 requests/minute, 200 records/request
- [Errors](https://docs.leadgenius.com/#errors)
- [Webhook](https://docs.leadgenius.com/#webhook)
- [Introducing the new LeadGenius API experience](https://www.leadgenius.com/resources/introducing-the-new-leadgenius-api-experience-real-time-enrichment-zero-bottlenecks)
- [Support](https://support.leadgenius.com/hc/en-us)

## Artifacts

- [Authentication profile](authentication/leadgenius-authentication.yml)
- [Conventions](conventions/leadgenius-conventions.yml)
- [Error catalog](errors/leadgenius-problem-types.yml)
- [Rate limits](rate-limits/leadgenius-rate-limits.yml)
- [Lifecycle](lifecycle/leadgenius-lifecycle.yml)
- [Conformance](conformance/leadgenius-conformance.yml)
- [Data model](data-model/leadgenius-data-model.yml)
- [MCP candidate tools](mcp/leadgenius-mcp.yml)
- [Agent skills](skills/_index.yml)
- [Well-known probe](well-known/leadgenius-well-known.yml)

## Company

- [Website](https://www.leadgenius.com)
- [About](https://www.leadgenius.com/about)
- [Product](https://www.leadgenius.com/product)
- [Solutions](https://www.leadgenius.com/solutions)
- [Customers](https://www.leadgenius.com/customers)
- [Resources / Blog](https://www.leadgenius.com/resources)
- [Sign up](https://app.leadgenius.com/sign-up)
- [Terms](https://www.leadgenius.com/legal/terms)
- [Privacy](https://www.leadgenius.com/legal/privacy)
- [CCPA](https://www.leadgenius.com/legal/ccpa)