DISCO Feeds API

All you need to know about DISCO API

In this guide, you will get to know everything about DISCO API; end points, filters, … etc. We also explain how you can retrieve your (alerts and saved searches) results within your API.

We should be answering all your questions here. In case we miss anything, please contact us; clicking on the contact us button at the bottom of this page or using the live chat.

Retrieve Articles

The “Retrieve Articles” endpoint enables users to fetch a list of articles based on different parameters such as language, filters, and pagination. By making a GET request to the designated API endpoint, developers can access the latest articles from their desired feeds.

To ensure seamless integration, the DiscoFeeds API supports various headers and request parameters. The “Accept” header specifies the desired response format, while the “x-disco” header authenticates the request. Additionally, the request payload can contain parameters like page size, page index, search query, language filters, and more.

By leveraging the power of the DiscoFeeds API, developers can effortlessly incorporate articles from multiple sources into their applications, providing their users with up-to-date and relevant content.

Request

GET https://api.disco.info/api/v1/feeds/articles

Headers

• Accept: application/json
• X-DISCO: YOUR_API_KEY
• Content-Type: application/json

Request Body

{
  "pageSize": 20,
  "pageIndex": 00,
  "filters": {
    "titles":[title_id1,title_id2,...],
    "lang": [
      {
        "value": "2",
        "label": "English"
      },
      {
        "value": "3",
        "label": "French"
      }
    ],
    "last_article_id": 1
  }
}

Example Request Curl

curl --location --request GET 'https://api.disco.info/api/v1/feeds/articles' --header 'Accept: application/json' --header 'x-disco: YOUR-API-KEY' --header 'Content-Type: application/json' --data '{
    "pageSize": 20,
    "pageIndex": 0,
    "filters": {
        "lang": [
            {
                "value": "2",
                "label": "English"
            },
              {
                "value": "3",
                "label": "French"
            }
        ],
        "last_article_id": 1
    }
}'

Response Body

The response will contain a JSON object with the list of articles matching the provided filters and pagination settings.

{
    "status": "success",
    "data": {
        "total": "4000",
        "data": [
            {
                "id": "11",
                "title_id": "11",
                "headline": "You've probably heard of Lorem Ipsum before",
                "summary": null,
                "author": "Lorem Ipsum",
                "date": "2023-01-15",
                "body": "<p>You've probably heard of Lorem Ipsum before – it's the most-used dummy text excerpt out there. People use it because it has a fairly normal distribution of letters and words (making it look like normal English), but it's also Latin, which means your average reader won't get distracted by trying to read it.</p>",
                "original_link": "https://example.com",
                "created_at": "171142229",
                "updated_at": null,
                "key": "79757234fc86f33f763f54c3efadb06135ebabd2a036",
                "images": [],
                "category": "News"
            }
        ]
    }
}

The response will include an array of article objects, where each object represents an article and contains the following properties: id: Unique identifier for the article. title: The title of the article. author: The author of the article. content: The content or body of the article. language: The language of the article. published_at: The date and time when the article was published.