Enrichments API

Enrich your own JSON data without creating a Datablist workspace, collection, or items. Send input rows, run an asynchronous task, and retrieve the results to use in your own application.

Building workflows

The Enrichments API is a standalone API for running enrichments and retrieving results. To build workflows that connect several steps, use the Datablist app.

Tasks use the same credits as the Datablist app. Paid enrichments consume your account balance.

The production REST base URL is:

text

https://api.datablist.com

A task runs in the background:

1. Send your input rows and a uniqueId to create the task.
2. Check its status every few seconds.
3. When it is completed, failed, or stopped, read the results.

Results keep your input order and inputId values, so you can match them to your own records.

Start with the quickstart. Before creating a task, use the catalog to discover the IDs, JSON schemas, limits, and pricing details for each enrichment.

Enrichments and sources

	Enrichment tasks	Source tasks
Request	Settings and input rows with your inputId values	Settings only
Results	One final result per original input, correlated by inputId	Flat generated JSON objects
Collection required	No	No
Guide	Enrichment quickstart	Sources quickstart

Both families share account limits, credit accounting, cancellation, and retention. Use the separate Sources API to generate data from settings instead of enriching rows you already have.

Endpoints

All paths below are relative to https://api.datablist.com.

Operation	Endpoint
Discover	GET /v1/enrichments
Read schema	GET /v1/enrichments/{enrichmentId}
Create	POST /v1/enrichments/tasks
History	GET /v1/enrichments/tasks
Poll	GET /v1/enrichments/tasks/{taskId}
Inputs	GET /v1/enrichments/tasks/{taskId}/inputs
Results	GET /v1/enrichments/tasks/{taskId}/results
Cancel	POST /v1/enrichments/tasks/{taskId}/stop

See API endpoints for authentication and datastore URLs.