Email Parser API

Parse any email into clean, structured data.

One API call turns a raw email thread into clean Markdown, metadata, AI labels, and semantic vectors. No regex. No HTML wrangling. Just data.

Fetch a parsed email thread
# Get a thread in markdown format (default)
curl https://inboxparse.com/api/v1/threads/{thread_id} \
  -H "Authorization: Bearer ip..."

# Response (simplified)
{
  "data": {
    "id": "thread_01jxxxxxxxxxxxxxxxx",
    "subject": "Re: Proposal Q2",
    "message_count": 3,
    "labels": {
      "category": "sales",
      "action": "reply",
      "sentiment": "positive"
    },
    "messages": [
      {
        "from": "mark@startup.io",
        "date": "2026-03-07T14:32:00Z",
        "content": {
          "markdown": "Hi,\n\nFollowing up on the Q2 proposal..."
        }
      }
    ]
  }
}

Email → Markdown

HTML emails are cleaned, reformatted and converted to LLM-optimized Markdown. Tables, links and structure preserved.

AI Labels included

Every thread is automatically labelled by category, action and sentiment using Gemini 3.0 Flash.

Thread-aware parsing

Emails are grouped into proper threads using RFC 5256, giving your agent full conversation context.

Three output formats

Use ?format=markdown (default), ?format=full (all fields), or ?format=raw (original HTML) - same endpoint.

REST API, no SDK required

Standard Bearer auth, JSON responses, cursor pagination. Any HTTP client works - curl, fetch, httpx, axios.

IMAP & Gmail OAuth

Connect any mailbox via IMAP or Gmail OAuth. Credentials encrypted at rest, never stored in plaintext.

Control output format per request

Copy-and-paste ready. No boilerplate.

Control output format per request
# Full format - all fields including raw HTML
curl "https://inboxparse.com/api/v1/threads/{id}?format=full" \
  -H "Authorization: Bearer ip..."

# Markdown only - minimal payload for LLMs
curl "https://inboxparse.com/api/v1/threads/{id}?format=markdown" \
  -H "Authorization: Bearer ip..."

# Raw HTML - for custom processing
curl "https://inboxparse.com/api/v1/threads/{id}?format=raw" \
  -H "Authorization: Bearer ip..."

# List all threads with cursor pagination
curl "https://inboxparse.com/api/v1/threads?limit=25&cursor=..." \
  -H "Authorization: Bearer ip..."

Frequently asked questions

What email formats does the parser support?+

InboxParse handles all standard email formats including HTML, plain text, multipart/mixed, and multipart/alternative. It decodes UTF-8, quoted-printable, and base64 content automatically.

How does InboxParse differ from traditional email parsers?+

Traditional parsers extract raw fields. InboxParse goes further by converting HTML to clean Markdown, grouping messages into threads, and adding AI-powered labels for category, sentiment, and suggested action - all in a single API call.

Can I use InboxParse with my existing LLM pipeline?+

Yes. InboxParse outputs standard JSON with Markdown content, making it compatible with any LLM provider including OpenAI, Anthropic, Google, and open-source models. Use the output directly in prompts or embed it into your RAG pipeline.

Start parsing email in minutes.

Connect a mailbox, grab an API key, and GET your first thread. Free plan available.