HTTP API Structure

Smart Feed offers an HTTP API to interact with various components.

The base subdomain is

You must provide Content-Type: application/json header when you send JSON data to the API.


The majority of endpoints require authentication.

Authentication to the API happens via the basic HTTP authenticationopen in new window. Provide your app secret key as the username value. You don't need to provide a password.

curl -X GET '' \
  -H 'Content-Type: application/json'

If you chose to authenticate with an Authorization: Basic <credentials> header, provide the credentials as the Base64open in new window encoding of the $APP_SECRET_KEY:.

curl -X GET '' \
  -H "Authorization: Basic QVBJX0tFWTo=" \
  -H 'Content-Type: application/json'