List data feeds

GET

/api/v3/curations/data-feeds

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

• Production

Returns a paginated list of the company’s JSON data feeds — feeds that map fields from a JSON endpoint onto curations, as an alternative to RSS. For RSS feeds, see List curation feeds.

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.

keyword

string

limit

integer

page

integer

direction

string

Allowed values: asc desc

Responses

200

200 OK

Media type application/json

object

items

Array<object>

The shape returned for both RSS feeds (List curation feeds) and JSON data feeds (List data feeds) — type (0 RSS, 1 JSON data feed) tells the two apart. fieldMappings, authType, and hasAuthSecret are only meaningful on a JSON data feed.

object

uniqueId

string

title

string

description

string

feedUrl

string

type

0 RSS feed, 1 JSON data feed.

integer

isValid

boolean

validationCode

integer

nullable

crawl

boolean

archiveIntervalDays

integer

lastValidated

string

lastQueried

string

channelName

The channel this feed was originally created against, or blank for a feed shared to multiple channels with no single owner.

string

channelSlug

string

sharedChannelIds

Internal numeric identifiers of every channel this feed is shared with.

Array<integer>

tags

Array<string>

authType

0 — no authentication. 1 — bearer token.

integer

hasAuthSecret

Whether a credential is stored — the credential itself is never returned.

boolean

fieldMappings

Array<object>

object

source

string

target

string

createdAt

string

updatedAt

string

deletedAt

string

nullable

message

string

total

integer

Example

{
  "items": [
    {
      "uniqueId": "feed_data_2k9x",
      "title": "Vendor product catalog",
      "description": "Nightly product export from our commerce platform.",
      "feedUrl": "https://example.com/api/products.json",
      "type": 1,
      "isValid": true,
      "validationCode": 200,
      "crawl": false,
      "archiveIntervalDays": 1,
      "channelName": "The Weekly Brew",
      "channelSlug": "the-weekly-brew",
      "sharedChannelIds": [
        54212
      ],
      "authType": 1,
      "hasAuthSecret": true,
      "fieldMappings": [
        {
          "source": "object.name",
          "target": "title"
        },
        {
          "source": "object.sku",
          "target": "customField:vendor-sku"
        }
      ],
      "createdAt": "2026-05-01T09:00:00+00:00",
      "updatedAt": "2026-08-30T09:05:00+00:00"
    }
  ],
  "message": "Data feeds fetched successfully.",
  "total": 1
}