Discover (beta)

POST

/api/v3/curations/discover

Given a subject, Letterhead will try to curate a number of relevant articles to the channels you instruct the API. We try to ensure they are relevant and recent, but please note this API is in beta, and we can’t guarantee that these curations will always hit the mark.

Note that the v3 api requires a key generated from within the company-level settings, which are available only to Letterhead customers on a certain plan.

Version note: at present, you can only pass one channel identifier to channels. Shortly, you will able to pass multiple, or none - which will represent “all channels.”

Authorizations

• bearerAuth

Request Body

Media type multipart/form-data

object

api

required | When true, instructs the endpoint that you’re authenticating with an organization key as opposed to some other method. In almost all cases you will want to set this value to true.

string

Example

true

channels[]

required | string[] | An array of channel identifiers (or channel “slugs”) across which to create a curation.

string

Example

letterhead-example-newsletter

count

required | The number of articles you want Letterhead to try to curate for you. Minimum 1, maximum 10.

string

Example

3

subject

required | The subject for Letterhead to search.

string

Example

Florida Panthers

Responses

200