> ## Documentation Index > Fetch the complete documentation index at: https://docs.platform.gamezop.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Articles API > Returns a paginated list of the latest news articles for the Topic Group you specify. ## About this API This API returns a `data` array of the latest news articles for a Topic Group. 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](/publishers/feedzop/feedzop-news-feed-api). *** ## Important notes * `topic_group` is required. It decides which topics the articles come from. * The API is paginated. Use `limit` (5 to 100 articles per page, default 100) and `page` (starting from 1, default 1) to fetch more articles. * Not all articles have images. **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 day. Requests beyond this return an HTTP `429` error, with a message telling you how many seconds to wait before retrying. *** ## API specification ## OpenAPI ````yaml /openapi-fdzp.json get /v1/get-articles openapi: 3.1.0 info: title: Feedzop APIs version: 1.0.0 description: OpenAPI specification for the Feedzop News Feed API. servers: - url: https://api.feedzop.com description: Feedzop API security: - bearerAuth: [] paths: /v1/get-articles: get: summary: Get Articles API description: >- Returns a paginated list of the latest news articles for the Topic Group you specify. operationId: getArticles parameters: - name: topic_group in: query required: true description: >- 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](/publishers/feedzop/feedzop-news-feed-api#how-topic-groups-work). schema: type: string format: uuid example: 040e73a5-57d9-43d3-a98d-edfde41cd9f1 - name: limit in: query required: false description: >- Number of articles to return per page. Must be between 5 and 100. Defaults to 100. schema: type: integer minimum: 5 maximum: 100 default: 100 example: 100 - name: page in: query required: false description: Page number to return. Must be 1 or greater. Defaults to 1. schema: type: integer minimum: 1 default: 1 example: 1 responses: '200': description: HTTP 200 OK. Returns a list of articles. content: application/json: schema: $ref: '#/components/schemas/ArticlesResponse' examples: Success: summary: Success value: code: SUCCESS data: - description: >- Article 370 emerged as one of the big winners at the 72nd National Film Awards. Here's a look at the full list of winners. title: Article 370 Wins Big at the 72nd National Film Awards url: >- https://1234.read.feedzop.com/en-in/news/arts-and-entertainment/article-370-wins-big-72nd-national-film-awards-831919 images: - '' published_at: '2026-09-22T12:44:42Z' version: 1.1.2 success: true '401': description: Unauthorized. Occurs when the Bearer token is invalid or missing. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: Invalid Bearer Token: summary: Invalid Bearer Token value: success: false version: 1.1.2 data: message: Invalid Bearer Token '404': description: >- Not Found. Occurs when `topic_group` is a valid UUID, but no Topic Group with that ID exists. content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' examples: Topic Group not found: summary: Topic Group not found value: success: false version: 1.1.2 data: topic_group: - not found '422': description: >- Validation Error. Occurs when `topic_group` is missing or not a valid UUID, `limit` is outside 5 to 100, or `page` is less than 1. All invalid parameters are reported together in the `data` object. content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' examples: Missing topic_group: summary: Missing topic_group value: success: false version: 1.1.2 data: topic_group: - is required Invalid topic_group format: summary: Invalid topic_group format value: success: false version: 1.1.2 data: topic_group: - uuid format invalid limit below 5: summary: limit below 5 value: success: false version: 1.1.2 data: limit: - must be greater than or equal to 5 limit above 100: summary: limit above 100 value: success: false version: 1.1.2 data: limit: - must be less than or equal to 100 page below 1: summary: page below 1 value: success: false version: 1.1.2 data: page: - must be greater than or equal to 1 Multiple invalid parameters: summary: Multiple invalid parameters value: success: false version: 1.1.2 data: topic_group: - uuid format invalid limit: - must be greater than or equal to 5 page: - must be greater than or equal to 1 '429': description: >- Too Many Requests. Occurs when you exceed 10,000 requests in a day. The error message tells you how many seconds to wait before retrying. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: Rate limit exceeded: summary: Rate limit exceeded value: success: false version: 1.1.2 data: message: Too many requests, retry after 3600 seconds '500': description: >- Internal Server Error. Occurs in case of API outage or other unforeseen errors. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: Internal server error: summary: Internal server error value: success: false version: 1.1.2 data: message: Internal server error components: schemas: ArticlesResponse: type: object properties: code: type: string description: Status of the request. This is `SUCCESS` in successful responses. data: type: array description: Array of articles for the requested page. items: $ref: '#/components/schemas/Article' version: type: string description: Release version. success: type: boolean description: Boolean value that is `true` in successful responses. ErrorResponse: type: object properties: success: type: boolean description: Boolean value that is `false` in error responses. version: type: string description: Release version. data: type: object properties: message: type: string description: Error message. ValidationErrorResponse: type: object properties: success: type: boolean description: Boolean value that is `false` in error responses. version: type: string description: Release version. data: type: object description: >- Map of each problematic query parameter to a list of error messages for it. additionalProperties: type: array items: type: string Article: type: object properties: title: type: string description: Headline of the article. description: type: string description: >- Short summary of the article. You can display this as preview text below the title. url: type: string format: uri description: >- Link to the full article on Feedzop. This will always use your Feedzop Unique Link, so that ad revenue from your users can be attributed to you. We identify your account from your Bearer token and generate these links automatically. Send your users to this URL when they want to read the full article, and do not modify it. images: type: array description: >- Links to images related to the article. Not all articles have images: this array can contain empty strings, so check each entry before displaying it. **Use of images is at your own discretion.** We cannot transfer image licensing rights to you, and you are responsible for ensuring you have the right to display any image you use. items: type: string published_at: type: string format: date-time description: >- Publication date and time of the article in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: UUID description: >- You can find the Bearer token for this API under Settings & Admin > API Tokens within the [Gamezop Business Dashboard](https://dashboard.gamezop.com). ````