Content catalog API

Call the Catalog pull API with the base URL, authentication, endpoints, paging, rate limits, and HTTP status codes below. Filtering is on Filters. Response fields are on Response principles.

API facts

Rate limit:

• Limit: 50 requests per 60 seconds per content type, per app
• Feed keys: all keys for the same app share the limit
• Successful responses: no quota headers.

Endpoints

Content types are segregated by endpoint.

Recommendations is a separate option. You request currently trending content with ContentType (Story or Moment), not from your catalog. See Recommendations.

Example URL

https://blazefeed.clipro.tv/v1/stories?ApiKey={MyToken}

Treat feed URLs as credentials. The key travels in the URL, so it can appear in server logs, browser history, and CDN logs. Call the feed from your server, not from a browser.

Paging

Results are sorted most-recently-updated first. A deep walk can repeat or miss items if content updates mid-walk. Pull incrementally with UpdateTime.From and deduplicate by id. totalItems is the total matching your query, not the size of the current page.

Fetching by ID

The /ids endpoints take ContentIds and paging only. Any content filter you send with them is accepted and then ignored: you receive a 200 with unfiltered results, not an error. Filter on the list endpoints, then fetch by ID.

Example calls

Fetch all Stories

const fetchStories = async (apiKey, pageNum = 0, pageSize = 50) => {
  const response = await fetch(`https://blazefeed.clipro.tv/v1/stories?PageNum=${pageNum}&PageSize=${pageSize}&ApiKey=${apiKey}`);
  
  if (!response.ok) {
    throw new Error(`HTTP error! Status: ${response.status}`);
  }
  
  return await response.json();
};

Fetch videos by ID

const fetchVideosByIds = async (apiKey, contentIds) => {
  const idsParam = contentIds.map(id => `ContentIds=${encodeURIComponent(id)}`).join('&');
  const url = `https://blazefeed.clipro.tv/v1/videos/ids?${idsParam}&ApiKey=${apiKey}`;
  
  const response = await fetch(url);
  
  if (!response.ok) {
    throw new Error(`HTTP error! Status: ${response.status}`);
  }
  
  return await response.json();
};

HTTP return messages

The API returns the following codes.