List curations

GET

/api/v3/curations

const url = 'https://api.tryletterhead.com/api/v3/curations?api=true&status=0';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.tryletterhead.com/api/v3/curations?api=true&status=0' \
  --header 'Authorization: Bearer <token>'

Returns a paginated, filterable list of the company’s curations — every piece of content saved across all of the company’s channels, not scoped to one.

Query parameters

page (default 1), perPage (default 10, max 100).
keyword — search across the curation’s title, excerpt, and content.
status — 1 for curated (used in a newsletter), 0 for not yet curated; omit for both.
dateStart / dateEnd — filter by publication date.
feeds[] — filter to curations sourced from specific feed unique IDs (see List curation feeds and List data feeds).
sources[] — filter to curations from specific site names (see List curation sources).
tags[] — filter to curations carrying any of these tags.
excludeTags[] — exclude curations carrying any of these tags.
iabCategories[] — filter to curations classified under any of these IAB categories.
type[] — filter by curation type (see the type field below).

Results are sorted by publication date, newest first.

Authorizations

bearerAuth

Parameters

Query Parameters

api

required

boolean

Required. Set to true to authenticate with your company API key rather than a signed-in session.

page

integer

perPage

integer

keyword

string

status

string

Allowed values: 0 1

dateStart

string

dateEnd

string

feeds[]

Array<string>

sources[]

Array<string>

tags[]

Array<string>

excludeTags[]

Array<string>

iabCategories[]

Array<string>

type[]

Array<integer>

Responses

200

200 OK

application/json

object

aggregates

Array<object>

object

uniqueId

string

title

string

excerpt

string

content

string

author

string

siteName

string

originalUrl

string

image

string

imageAlt

string

imageCaption

string

imageOriginalUrl

string

publicationDate

string

dateOfAggregatePublication

string

curated

boolean

archived

boolean

archiveDate

string

nullable

useBy

string

nullable

feedUniqueId

string

nullable

type

Content type — 0 articles, 1 events, 2 AI-generated, 3 WordPress, 4 RSS, 5 browser extension, 6 Zapier, 7 JSON data feed.

integer

isGlobalCuration

Always true — every curation returned by this company-wide endpoint is.

boolean

createdAt

string

updatedAt

string

deletedAt

string

nullable

tags

Array<string>

categories

Array<string>

customFields

Present only when the curation has at least one custom field value set, keyed by the custom field’s key (see List curation custom fields).

object

total

integer

Example

{
  "aggregates": [
    {
      "uniqueId": "cur_8x2mle4kq9",
      "title": "How coffee prices are shaping this year's harvest",
      "excerpt": "A look at the trends driving bean prices higher.",
      "originalUrl": "https://example.com/coffee-prices",
      "siteName": "Example Daily",
      "publicationDate": "2026-08-30 09:00:00",
      "curated": true,
      "archived": false,
      "type": 4,
      "isGlobalCuration": true,
      "createdAt": "2026-08-30T09:05:00+00:00",
      "updatedAt": "2026-08-30T09:05:00+00:00",
      "tags": [
        "coffee",
        "agriculture"
      ]
    }
  ],
  "total": 128
}

Still can’t find what you need? Contact support.