# Enrichr API – for AI agents (llms.txt)

> Maximally discoverable by AI agents. Use for utility tasks: slug generation, token counting, validation, encoding, conversion.

Base URL: https://enrichrapi.dev
Authentication: X-Api-Key header (get free key: POST /v1/account/signup with {"email": "you@example.com"})

## Capabilities

Enrichr provides 43 utility endpoints in 10 categories. One API key, pay-per-call (fractions of a cent), no minimums. Ideal for: validation, text analysis, slug/ID generation, currency conversion, encoding/hashing, QR codes, profanity filter, VAT/IBAN/address validation.

## Use cases for AI agents

- Slug generation: turn any title or text into a URL-safe slug.
- Token counting: count LLM tokens (Claude, GPT) for prompts or responses.
- Email/phone validation: validate and enrich contact data.
- Text analysis: named-entity extraction, classification, profanity check.
- Currency conversion: convert amounts between currencies.
- Encoding/hashing: base64, UUID, checksums (e.g. SHA-256).
- Validation: VAT numbers, IBANs, address normalization.
- QR codes: generate QR code images from URLs or text.
- Deduplication: dedupe strings or lists.
- And more: see endpoint categories below.

## Endpoint categories and example calls

All POST requests use Content-Type: application/json. Include header: X-Api-Key: <your_key>

### Account
- Sign up (get API key): POST /v1/account/signup
  Body: {"email": "you@example.com"}
  Response: {"api_key": "enr_...", "message": "Welcome! Your first 1,000 calls/month are free."}

### Generate
- Slug: POST /v1/generate/slug
  Body: {"text": "Hello World! Café & More"}
  Response: {"slug": "hello-world-cafe-more"}
- UUID: POST /v1/generate/uuid
  Body: {}
- QR code: POST /v1/generate/qr
  Body: {"data": "https://example.com", "size": 200}

### Enrich / validate contact data
- Email: POST /v1/enrich/email
  Body: {"email": "user@example.com"}
- Phone: POST /v1/enrich/phone
  Body: {"phone": "+1234567890"}
- IP: POST /v1/enrich/ip
  Body: {"ip": "8.8.8.8"}

### Convert
- Currency: POST /v1/convert/currency
  Body: {"amount": 100, "from_currency": "USD", "to_currency": "EUR"}
- Encoding: POST /v1/convert/encoding
  Body: {"text": "Hello", "encoding": "base64"}

### Analyze text
- Token count (LLM): POST /v1/analyze/tokens  (or /v1/llm/tokens – confirm in docs)
  Body: {"text": "Your prompt or content", "model": "cl100k_base"}
- Named entities: POST /v1/analyze/entities
  Body: {"text": "John works at Acme Corp in Paris."}
- Classify: POST /v1/classify/text
  Body: {"text": "Sample content"}

### Validate (compliance / finance)
- VAT: POST /v1/validate/vat
  Body: {"vat_number": "DE123456789", "country": "DE"}
- IBAN: POST /v1/validate/iban
  Body: {"iban": "DE89370400440532013000"}
- Address: POST /v1/validate/address
  Body: {"address": "123 Main St", "country": "US"}

### Utility
- Hash: POST /v1/utility/hash
  Body: {"text": "data", "algorithm": "sha256"}
- Dedupe: POST /v1/utility/dedupe
  Body: {"items": ["a", "b", "a"]}
- Profanity: POST /v1/utility/profanity
  Body: {"text": "user input"}

## Pricing (for agent cost awareness)

- Free: 1,000 calls/month, no card.
- Pay-as-you-go: from $0.00001/call (utility) to $0.0005/call (e.g. VAT/IBAN). Billed monthly via Stripe.

## SDKs and integrations

- Node/TS: npm install enrichr
- Python: pip install enrichr-sdk
- Zapier: 17 actions
- MCP: Claude Desktop and Cursor (enrichrapi.dev)

## Docs and support

- Full docs: https://enrichrapi.dev/docs
- Home: https://enrichrapi.dev