Retrieve News Articles by Ids

Retrieve information about one or more news articles by their ids. The ids can be retrieved from the search news or top news APIs.

GET
https://api.worldnewsapi.com/retrieve-news
Example Request and Response
GET
https://api.worldnewsapi.com/{{ examples.getRetrieveNews }}
{
    "news": [
        {
            "id": 2352,
            "title": "While China and the US squabble, the world’s debt and climate crises worsen - Amnesty International",
            "text": "...",
            "summary": "...",
            "url": "https://www.amnesty.org/en/latest/news/2020/09/while-china-and-the-us-squabble-the-world-debt-and-climate-crises-worsen/",
            "image": "https://www.amnesty.org/en/wp-content/uploads/2021/06/272748-1024x433.jpg",
            "video": null,
            "publish_date": "2020-09-11 18:05:26",
            "authors": [
                "Amnesty International",
                "William Nee"
            ],
            "language": "en",
            "category": "politics",
            "source_country": "mx",
            "sentiment": -0.176
        },
        {
            "id": 2354,
            "title": "Sexual violence against Hong Kong protesters – what’s going on? - Amnesty International",
            "text": "...",
            "summary": "...",
            "url": "https://www.amnesty.org/en/latest/news/2019/12/sexual-violence-against-hong-kong-protesters/",
            "image": "https://www.amnesty.org/en/wp-content/uploads/2021/06/264281-1024x433.jpg",
            "video": null,
            "publish_date": "2019-12-20 11:14:17",
            "authors": [
                "Amnesty International"
            ],
            "language": "en",
            "category": "politics",
            "source_country": "mx",
            "sentiment": -0.449
        }
    ]
}
cURL
Java
Javascript
Python
Go
C#
 {{ codeCopyText }}
 {{ codeCopyText }}
 {{ codeCopyText }}
 {{ codeCopyText }}
 {{ codeCopyText }}
 {{ codeCopyText }}

Frequently Asked Questions

How do I retrieve a specific news article by ID?

Use the GET /retrieve-news endpoint with the ids parameter. You can pass one or more comma-separated article IDs that you obtained from the Search News or Top News endpoints.

What data fields are included in a news article response?

Each article includes the title, full text, summary, URL, image URL, video URL, publish date, authors, language, category, source country, and sentiment score.

Can I retrieve the full article text?

Yes. The retrieve-news endpoint returns the complete article text in the text field, along with a shorter summary in the summary field.


Questions? Need Help? Ask Away