What types of sensitive information can the API anonymize?

The API can detect and anonymize a wide range of sensitive information including personal identifiers (names, emails, phone numbers), financial data (credit card numbers, bank accounts), locations (addresses, coordinates), dates, and custom entity types. The AI model is trained to recognize patterns and context to ensure comprehensive anonymization.

What are the usage limits for the Text Anonymization API?

API Codex uses one credit-based subscription across every API in the catalog. The Free plan includes 1,000 credits per month, Starter ($29.99/month) includes 50,000 and Pro ($99.99/month) includes 250,000. Each anonymization request costs 25 credits, so that covers roughly 40 requests per month on Free, 2,000 on Starter and 10,000 on Pro. Only successful (2xx) responses consume credits. If you need higher limits, contact us for a custom plan.

Is the API GDPR and CCPA compliant?

Yes, the Text Anonymization API is designed to help organizations achieve GDPR, CCPA, and HIPAA compliance. The API processes data securely without storing sensitive information, and automatically redacts personal data to meet privacy regulations. All processing is done in memory with encrypted connections, and no source content or PII is retained after anonymization. This makes it ideal for organizations that need to share data while maintaining regulatory compliance.

How does the API handle context-dependent entity detection?

Our AI uses advanced natural language processing to understand context and distinguish between PII and normal text. For example, 'John Smith' in a signature block is detected as a person's name, while 'John Smith Avenue' is recognized as a street address component. The model analyzes surrounding text, capitalization patterns, and linguistic structure to accurately identify entities based on their contextual usage rather than simple pattern matching.

Can I define custom entity types for anonymization?

Yes, the API supports custom entity detection beyond the standard PII categories. You can define custom patterns and entity types specific to your industry or use case. For example, you might want to anonymize employee IDs, project codes, internal department names, or proprietary terminology. Custom entity support is available on Pro plans and above, allowing you to tailor the anonymization process to your organization's specific privacy requirements.

What's the difference between redaction and pseudonymization?

The API supports multiple anonymization strategies. Redaction completely removes or masks sensitive data by replacing it with placeholders like [PERSON] or [EMAIL]. Pseudonymization replaces real values with consistent fake values, maintaining data structure and relationships for analytics while protecting privacy. For example, 'john@acme.com' might become '[EMAIL]' (redaction) or 'user123@example.com' (pseudonymization). You can specify your preferred approach based on whether you need to preserve data utility for analysis or completely eliminate sensitive information.

AI-powered privacy protection and data anonymization

Text Anonymization API

Name: Text Anonymization API
Brand: API Codex
SKU: text-anonymization-api

AI-powered API for anonymizing sensitive information in text, files, and web content. The Text Anonymization API provides a secure and efficient way to identify and redact sensitive information from various content sources.

Using advanced AI technology, the API can detect and anonymize a wide range of entity types including personal information, dates, locations, financial data, and more with enterprise-grade security.

Get a free API key Read the docs

Free tier included, no credit card required. One key works across every API.

Free calls / month: 40
Entity Types: 20+
Accuracy Rate: 97.8%
Compliance: 100%

Get your free API key

40 free calls on the free plan

Key features

Anonymize plain text with customizable entity redaction
Process content from uploaded files (PDF, TXT, HTML)
Anonymize content from web URLs
Flexible input/output formats with JSON responses
Secure API with enterprise-grade authentication

Built for

Privacy compliance (GDPR, CCPA, HIPAA)
Document sanitization for legal teams
Customer data protection systems
Research data anonymization
Healthcare records processing
Financial document redaction
HR document protection
Data sharing compliance

MCP · for your agent

Hand the Text Anonymization API to your agent

Connect Claude, Cursor or any MCP client once, then ask in plain words. Your agent finds this API, reads its docs and makes the call: 25 credits per call, the same as REST, from your team's balance.

Connect your agent

Redact tickets before sharing

“Redact names, emails, phone numbers and card numbers from these 50 support tickets before we send them to our outsourced support team.”

list_apis · get_api_docsfree

api_request POST /text-anonymization/v1/anonymize/text 25 cr

Each ticket with personal data replaced by typed placeholders, and a list of what was removed.

Scrub secrets from a log

“I need to paste this error log into a public GitHub issue. Strip API keys, IP addresses and emails first.”

list_apis · get_api_docsfree

api_request POST /text-anonymization/v1/anonymize/text 25 cr

The log with keys, secrets, IPs and emails masked, safe to post publicly.

Anonymize research interviews

“Anonymize the interview transcript at this link for our research repository: people, companies and places.”

list_apis · get_api_docsfree

api_request POST /text-anonymization/v1/anonymize/url 25 cr

The transcript with people, organizations and locations replaced, and counts per entity type.

$ claude mcp add --transport http apicodex https://mcp.apicodex.io

Illustrative asks; the calls and prices are real. Claude, Cursor, VS Code and Windsurf setup: mcp.apicodex.io

Try it

Build the request for your data

Edit the parameters below and see the exact request and curl command you'd send. No key required to preview.

POST /text-anonymization/v1/anonymize/text

Open in Playground

Request · HTTP

POST /text-anonymization/v1/anonymize/text HTTP/1.1
Host: api.apicodex.io
Content-Type: application/json
X-Api-Key: YOUR_API_KEY

{
  "text": "John Smith works at Acme Inc. Email: [email protected]",
  "entities": ["PERSON", "EMAIL", "ORG"]
}

Response · JSON 200 OK

{
  "success": true,
  "anonymized_text": "[PERSON] works at [ORG]. Email: [EMAIL]",
  "entities_found": [
    { "type": "PERSON", "value": "John Smith", "start": 0, "end": 10 },
    { "type": "ORG", "value": "Acme Inc", "start": 20, "end": 28 },
    { "type": "EMAIL", "value": "[email protected]", "start": 37, "end": 50 }
  ]
}

Run it with your key

Documentation

Text Anonymization API Documentation

Learn how to use the Text Anonymization API to protect sensitive information in your content. The API supports text input, file uploads, and URL-based content processing.

Base URL

url

https://api.apicodex.io/text-anonymization

Authentication

Authenticate every request with your API key: send it in an X-Api-Key header, or pass it as an ?apikey= query parameter.

headers

{
"X-Api-Key": "YOUR_API_KEY"
}

Request and response

Illustrative values. Confirm current endpoint behavior, quotas, and data freshness in the API documentation before production use.

request · http

POST /text-anonymization/v1/anonymize/text HTTP/1.1
Host: api.apicodex.io
Content-Type: application/json
X-Api-Key: YOUR_API_KEY

{
  "text": "John Smith works at Acme Inc. Email: [email protected]",
  "entities": ["PERSON", "EMAIL", "ORG"]
}

response · json

{
  "success": true,
  "anonymized_text": "[PERSON] works at [ORG]. Email: [EMAIL]",
  "entities_found": [
    { "type": "PERSON", "value": "John Smith", "start": 0, "end": 10 },
    { "type": "ORG", "value": "Acme Inc", "start": 20, "end": 28 },
    { "type": "EMAIL", "value": "[email protected]", "start": 37, "end": 50 }
  ]
}

Code examples

JavaScript/Node.js

const axios = require('axios');

const options = {
  method: 'POST',
  url: 'https://api.apicodex.io/text-anonymization/v1/anonymize/text',
  headers: {
    'content-type': 'application/json',
    'X-Api-Key': 'YOUR_API_KEY'
  },
  data: {
    text: 'John Smith works at Acme Inc. Contact: [email protected]',
    entities: ['PERSON', 'EMAIL', 'ORG']
  }
};

try {
  const response = await axios.request(options);
  console.log(response.data);
} catch (error) {
  console.error(error);
}

Python

import requests

url = "https://api.apicodex.io/text-anonymization/v1/anonymize/text"

payload = {
    "text": "John Smith works at Acme Inc. Contact: [email protected]",
    "entities": ["PERSON", "EMAIL", "ORG"]
}

headers = {
    "content-type": "application/json",
    "X-Api-Key": "YOUR_API_KEY"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

cURL

curl --request POST \
  --url https://api.apicodex.io/text-anonymization/v1/anonymize/text \
  --header 'content-type: application/json' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --data '{
    "text": "John Smith works at Acme Inc. Contact: [email protected]",
    "entities": ["PERSON", "EMAIL", "ORG"]
  }'

Endpoints

POST /v1/anonymize/text

Send the text as JSON {"text": "..."}, as text/plain, or as a multipart text field.

POST /v1/anonymize/upload

Upload a PDF, HTML or plain-text file (multipart/form-data, field name: file).

curl -X POST "https://api.apicodex.io/text-anonymization/v1/anonymize/upload" -H "X-Api-Key: YOUR_API_KEY" -F "[email protected]"

POST /v1/anonymize/url

Fetch a public URL and process its text. JSON body: {"url": "https://..."}.

Entity Types

The API supports the following types of analysis:

PERSON Names and personal identifiers

EMAIL Email addresses

PHONE Phone numbers

ADDRESS Physical addresses

DATE Dates and timestamps

LOCATION Place names and coordinates

FINANCIAL Credit cards, bank accounts

ID ID numbers, passports, SSN

CUSTOM User-defined patterns

Pricing

Text Anonymization API Pricing

This API costs 25 credits per request. Credits are shared across every API on your plan.

Estimate your monthly cost

Drag the slider to match your expected request volume. We'll recommend the cheapest plan that covers it.

Requests per month 10,000

Recommended plan

Starter

$29.99 /month

Credits used

Credits included

Cost per 1K requests

Choose Starter

Free

1,000 credits · ~40 requests/mo · 2 rps

All APIs included
No credit card required
Full documentation and examples
MCP server for your AI agents
Up to 5 active API keys

Start for free

Starter

Popular

$29.99 /month

50,000 credits · ~2,000 requests/mo · 10 rps

All APIs included
Email support
Usage dashboard and analytics
MCP server for your AI agents
Up to 5 active API keys

Start with Starter

Pro

$99.99 /month

250,000 credits · ~10,000 requests/mo · 25 rps

All APIs included
Priority support
MCP server for your AI agents
Up to 5 active API keys

Start with Pro

FAQ

Text Anonymization API

Key features

Built for

Hand the Text Anonymization API to your agent

Redact tickets before sharing

Scrub secrets from a log

Anonymize research interviews

Build the request for your data

Text Anonymization API Documentation

Base URL

Authentication

Request and response

Code examples

Endpoints

POST /v1/anonymize/text

POST /v1/anonymize/upload

POST /v1/anonymize/url

Entity Types

Text Anonymization API Pricing

Free

Starter

Pro

Need a different plan?

Frequently asked questions

Related APIs