Skip to main content
GET
Get Articles API

About this API

This API returns the latest news articles for a Topic Group, newest first. You can use it to build a news feed in your app / website. Before you start, make sure you have gone through the Feedzop News Feed API overview.

Important notes

  • topic_group is required. It decides which topics the articles come from. If it’s missing, or doesn’t match a Topic Group created for you, the API returns 404.
  • The API is paginated. Use limit (5 to 100 articles per page, default 100) and page (starting from 1, default 1). Keep fetching the next page while meta.pagination.has_more is true.
  • Not all articles have images. For those articles, images is null. If you choose to display images, you do so at your own discretion. We cannot transfer image licensing rights to you.
  • Each partner can make up to 10,000 requests per rolling 24 hours. Every successful response includes an x-rate-limit-remaining header. Requests beyond the limit return 429, with a Retry-After header giving the number of seconds to wait.
  • Every error response has the same shape: success: false, version, and an error object with a code you can handle in your code and a human-readable message. 400 errors also include error.details, listing the problem with each invalid parameter.

API specification

Authorizations

Authorization
string
header
required

You can find the Bearer token for this API under Settings & Admin > API Tokens within the Gamezop Business Dashboard.

Query Parameters

topic_group
string<uuid>
required

ID of the Topic Group whose articles you want to fetch. A Topic Group is a set of entities (people, teams, organisations, etc.) created specifically for you, and the API returns articles that mention these entities. Your Gamezop Account Manager will share your Topic Group IDs. Learn more.

limit
integer
default:100

Number of articles to return per page. Must be between 5 and 100. Defaults to 100.

Required range: 5 <= x <= 100
page
integer
default:1

Page number to return. Must be 1 or greater. Defaults to 1.

Required range: x >= 1

Response

HTTP 200 OK. Returns a page of articles.

success
boolean

Boolean value that is true in successful responses.

version
string

Release version.

data
object
meta
object