Getting started with the Curated API

Curated has a public API which can be used by publication owners to integrate Curated into other sites.

The base URL for the API is:

https://api.curated.co/api/v3

Authentication

The Curated API uses token based authentication. To get a successful response from the API you must include a HTTP header in the following format:

Authorization: Token token="API_KEY"

Finding your API Key

The API key can be found on your account page under "Account API Key".

Publication

Most endpoints require a publication id, for example:
GET /publications/{publication_id}/issues.

You can find a list of your publication ids by using the GET /publications endpoint.

Data Format

The Curated API outputs all data as JSON and expects any data submitted to also be JSON.

For example, you can request the issue summary data with the following cURL command:

curl -X GET https://api.curated.co/api/v3/publications/4513/issues \
-H "Accept: application/json" \
-H "Content-type: application/json" \
-H 'Authorization: Token token="API_KEY"'

The response will be JSON formatted data:

{
	"issues": [{
		"number": 2,
		"published_at": "2014-08-24T19:44:48.344+01:00",
		"summary": "This is the issue summary",
		"title": "Issue 2",
		"updated_at": "2014-08-24T19:50:56.937+01:00",
		"url": "https://your-publication.curated.co/issues/2"
	}, {
		"number": 1,
		"published_at": "2014-08-16T01:21:58.390+01:00",
		"summary": "This is the issue summary",
		"title": "Issue 1",
		"updated_at": "2014-08-24T12:00:03.535+01:00",
		"url": "https://your-publication.curated.co/issues/1"
	}],
	"page": 1,
	"total_pages": 1,
	"total_results": 2
}

Date Formats

All date formats are ISO8601.

HTTPS

All API requests must be made over HTTPS, the API will not respond on HTTP.

Limitations

• You can only collect links, not text items
• You can’t publish issues, you will need publish an issue by logging into your Curated account

Have any feedback?

Let us know how the API works for you. If you've got ideas, questions, or comments, let us know!