Documentation

Date Parser API is a REST API that can be used to extract specific dates mentioned within a text. Since the use of Natural Language Processing is on the rise, Date Parser API is an essential tool for multiple applications.

Every response from the API is delivered in the same format, an array of parsed dates. For more information about the response format, please refer to the API reference. Every parsed date has the same five properties. Here is a description of the five properties:

Property Type Description Example
from: "I love 25 Dec 2017"
date String The actual date extracted. Dates are string, following ISO format: YYYY-MM-DDThh:mm:ss.mlsZ. Careful! -> All dates are based on the UTC timezone. 2017-12-25T00:00:00.000Z
ms Integer The total number of milliseconds between the extracted date and 1970-01-01T00:00:00:000Z 1514160000000
epoch Integer The total number of seconds between the extracted date and 1970-01-01T00:00:00:000Z 1514160000
match String The expression from which the date comes from. It is a subexpression of the text passed as a parameter to the service. 25 Dec 2017
index Integer The index is the position of the match expression inside the text passed as a parameter to the service. Position 0 means that the subexpression begins at the start of the sentence. 7

API Keys

All our routes are protected and to access them, you must provide a valid API key. To get one, subscribe to one of our plans. You can try it for free, but must provide an email, so that we can manage your API key. To authorize a request, add your API key to your request headers as a 'x-api-key'. Example: {"x-api-key" : "#yourAPIkey#"}

API Reference

Supported expressions

Here is a list of a few supported formats of text from which dates can be extracted. There are many other expressions that Date Parser will recognize. If a specific expression is not yet supported, please feel free to contact us.

Absolute dates
Example Resulting Date (simplified)

Relative dates
Example Result Date (simplified)