---
title: "Text Entity & Date Extraction API"
slug: text-entity-date-extraction
url: https://apyhub.com/skycraft/service/text-entity-date-extraction
provider: Skycraft
auth: api_key
version: v1
service_type: sync
endpoints: 2
atoms: 20
mcp: true
---

# Text Entity & Date Extraction API

Extract people, places, organizations and dates from free text, with normalized date values and character positions for every match. Fast JSON REST API.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/skycraft/text-entity-date-extraction/extract-entities` | What it does Extracts named entities from the provided text and identifies their type, such as peop… | 20 |
| GET | `https://api.eu.apyhub.com/skycraft/text-entity-date-extraction/extract-dates` | What it does Extracts date mentions from the input text and returns them in a JSON object. The resp… | 20 |

## Endpoint reference

### Extract Entities API

`GET https://api.eu.apyhub.com/skycraft/text-entity-date-extraction/extract-entities` · 20 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `text` | query | string | yes | Example: `Jim Carrey is an actor from Canada`. |

#### Quickstart

Find entities in a piece of text by passing the text as a query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/skycraft/text-entity-date-extraction/extract-entities?text=Jim%20Carrey%20is%20an%20actor%20from%20Canada" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with an `entities` array. Each entity is an object with `type`, `image`, `value`, `end_position`, and `start_position` fields.

```json
{
  "entities": [
    {
      "type": "PER",
      "value": "Jim Carrey",
      "start_position": 0,
      "end_position": 10,
      "image": "https://upload.wikimedia.org/wikipedia/commons/8/8b/Jim_Carrey_2008.jpg"
    },
    {
      "type": "LOC",
      "value": "Canada",
      "start_position": 28,
      "end_position": 34,
      "image": null
    }
  ]
}
```

### Extract Dates API

`GET https://api.eu.apyhub.com/skycraft/text-entity-date-extraction/extract-dates` · 20 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `text` | query | string | yes | Example: `On 5th or April, 2035 there will be flying cars - 2023-02-12.`. |

#### Quickstart

Send the text to scan in the query string to extract any dates it contains.

```bash
curl -X GET "https://api.eu.apyhub.com/skycraft/text-entity-date-extraction/extract-dates?text=On%205th%20of%20April%2C%202035%20there%20will%20be%20flying%20cars%20-%202023-02-12." \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `dates` array. Each item in `dates` is an object with `tag`, `date`, `end_position`, `start_position`, and `normalized_date` fields describing each detected date.

```json
{
  "dates": [
    {
      "tag": "DATETIME",
      "date": "2023-02-12",
      "end_position": 60,
      "start_position": 50,
      "normalized_date": 1676160000000
    }
  ]
}
```

## About

## What it does
Text Entity & Date Extraction API pulls structured facts out of free text. Send a sentence or passage as the `text` query parameter and get back JSON listing every named entity or date mention found, each with its exact character position in the input.

`Extract Entities` takes `text` and returns an `entities` array; each item carries the matched `value`, its `type` (such as person, location, or organization), an `image` URL where one is available, and `start_position`/`end_position` offsets. `Extract Dates` takes `text` and returns a `dates` array; each item carries the matched `date` string, a `normalized_date` timestamp, a `tag`, and `start_position`/`end_position` offsets.

Text Entity & Date Extraction API is a good fit when you need to tag people, places, and organizations in articles, turn natural-language dates in emails or notes into machine-readable values, or highlight extracted spans directly in a UI.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/skycraft/service/text-entity-date-extraction