text-extract-emails Edge Function — Content

text-extract-emails — Extract Email Addresses from Text

Extracts all valid email addresses from any free-form text. Uses an RFC 5321 compliant pattern. Supports deduplication and preserves order of first appearance.

---

API

POST /api/text-extract-emails

Request body

Field	Type	Required	Default	Description
text	string	✅	—	Free-form text to extract email addresses from
unique	boolean	❌	true	Deduplicate emails case-insensitively

Success response (200)

{
  "success": true,
  "data": {
    "emails": ["alice@example.com", "bob@domain.org"],
    "count": 2
  }
}

Error responses

Code	HTTP	When
INVALID_INPUT	400	Missing or invalid text field
INTERNAL_ERROR	500	Unexpected processing error

---

Usage

cURL

curl -X POST "$FUNCTION_URL/api/text-extract-emails" \
  -H "Content-Type: application/json" \
  -d '{"text": "Please contact alice@example.com or support@company.io for help."}'

TypeScript / JavaScript (HTTP)

const response = await fetch(`${FUNCTION_URL}/api/text-extract-emails`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    text: document,
    unique: true,
  }),
});
const { data } = await response.json();
console.log(data.emails); // ['alice@example.com', 'support@company.io']
console.log(data.count);  // 2

Direct import (Node / Bun / Deno)

import { extractEmails } from '@aerostack/functions/text-extract-emails';

const result = extractEmails({
  text: 'From: sender@example.com\nTo: recipient@example.org\nCC: cc@example.net',
  unique: true,
});
console.log(result.emails); // ['sender@example.com', 'recipient@example.org', 'cc@example.net']
console.log(result.count);  // 3

---

Use Cases

• Contact list building: Extract email addresses from pasted text, CSV files, or documents to build a mailing list.
• Email parsing pipelines: Extract sender/recipient addresses from raw email content or headers for routing and analytics.
• Web scraping: Pull contact emails from scraped web page content.
• Data cleaning: Extract and deduplicate email addresses from messy user-submitted text fields.

---

Notes

• Deduplication (unique: true) is case-insensitive: Hello@Example.COM and hello@example.com are treated as the same address. The first occurrence is kept.
• Emails are returned in order of first appearance in the text.
• Invalid patterns like bad..email@example.com (consecutive dots in local part) are rejected.
• The function does not validate whether a domain or mailbox actually exists — it only checks format validity.