Parse HTML and Text Documents Using API

In this article we'll see how to parse HTML and TXT documents using Parsio API.

Authentication

To access the API, you will need the API key that you will find in your account:

This API key should be included in the X-API-Key HTTP header.

Unauthenticated responses will return in a HTTP 401 Unauthorized code.

Here's a request example using cURL:

curl -X GET https://api.parsio.io/mailboxes/ -H "X-API-Key: <YOUR_API_KEY>"

How to parse HTML and text documents using Parsio API

API Endpont: POST https://api.parsio.io/mailboxes/<mailbox_id>/doc

JSON parameters:

name (string): Document's name (or Subject for emails)
html (string): HTML content
text (string): Text content
from (string): 'From' email address (optional)
to (string): 'To' email address (optional)
meta (object): Payload document data (optional)

If both provided, the HTML content has priority over the TEXT content. At least one must be provided.

If needed, you can provide some payload data in the meta field, which will be included in the parsed JSON as the __meta__ field. This can be helpful for linking the document with your external database, for example.

Your Mailbox ID can be found in the browser location bar:

Code samples

CURL:

curl \
-X POST \
https://api.parsio.io/mailboxes/<YOUR_MAILBOX_ID>/doc \
-d '{
"name": "New order",
"from": "admin@example.com",
"to": "me@example.com",
"html": "<p>HTML content goes here</p>"
}' \
-H "Content-Type: application/json" \
-H "X-API-Key: <YOUR_API_KEY>"

Find more code samples here.