Introduction
API endpoints
Annotate Named entity recognition Categorize Semantic similarity Sentiment Extract article information Detect language
Get articles Get articles for topic page Get article details Stream of new articles
Get events Get events for a topic page Get event details Stream of events Get list of breaking events
Get mentions
Suggest concepts Suggest categories Suggest sources Suggest authors Suggest locations Suggest event types
API Usage
Reference
Terminology
Supported languages
Response format
Building queries
Search query language
Keyword search modes
Integrations
MCP Integration
OverviewExample 1Example 2Example 3

Get articles for topic page

Try in sandbox  

Obtain articles that match a user generated topic page.

Retrieve the news articles that match the topic page that the user generated on the Media Monitoring page.

The topic page has to be created using the web interface and can be defined by a list of concepts, keywords, news sources, categories and other available conditions. Each topic page has a unique id, called a URI. When you open the topic page, the URI is displayed in the URL in the browser (e.g. "240f6a12-b9d8-40a6-b1c6-a220e31d08de"). Use that URI as the parameter when making the API calls.

Compared to the Get Articles endpoint, this endpoint is well suited when you want to find articles that match a broader topic that can be defined using a set of concepts and keywords. These concepts and keywords don't all need to be mentioned in an article, but the more of them are mentioned, the higher will the article be in the list of results. By default, the returned articles are sorted based on how well they match the topic, but you can also change the sorting by setting the articlesSortBy parameter.

The results of the search can be the list of matching articles (default) or one of the various aggregates (summaries) of the matching articles. In case of the aggregates, for example, the returned data can contain information about when the articles matching the topic were published, who published them, etc.

Endpointhttps://eventregistry.org/api/v1/article/getArticlesForTopicPage
HeadersContent-Type: application/json

Retrieve articles that match a public topic page related to Renewable energy (with uri 240f6a12-b9d8-40a6-b1c6-a220e31d08de). Return articles sorted by relevance (most relevant first).

Request body

Parameters 
apiKey  string (required)

Your API key

uri  string (required)

URI of the topic page for which you wish to retrieve matching articles. Obtain the URI from the URL on the monitoring page when the topic page is opened.

resultType  string

Define what kind of results of the search you would like to get.

Available values:  articles, uriWgtList, langAggr, timeAggr, sourceAggr, sourceExAggr, authorAggr, keywordAggr, locAggr, conceptAggr, conceptGraph, categoryAggr, dateMentionAggr, sentimentAggr
Default value:  articles
maxDaysBack  integer

The returned articles should not be older than this number of days. If the value is not specified, then the value set in the topic definition will be used.

onlyAfterTm  string

Only include in the results articles that were found after the specified date-time. The parameter should be in the format YYYY-MM-DDTHH:MM:SS, where the value should be in the UTC timezone. The value is very handy if you want to repeatedly call the API endpoint and make sure that you don't receive the same articles multiple times.

articlesPage  integer

Determines the page of the results to return (starting from 1). Relevant when resultType = articles.

Default value:  1
articlesCount  integer

Define how many articles (up to 100) will be returned. Relevant when resultType = articles.

Default value:  100
articlesSortBy  string

Choose the criteria for sorting the news articles. rel (relevance to the query), date (publishing date), sourceImportance (manually curated score of source importance - high value, high importance), sourceImportanceRank (reverse of sourceImportance), sourceAlexaGlobalRank (global rank of the news source), sourceAlexaCountryRank (country rank of the news source). Relevant when resultType = articles.

Available values:  date, rel, sourceImportance, sourceAlexaGlobalRank, sourceAlexaCountryRank
Default value:  date
articlesSortByAsc  boolean

Should the results be ordered in ascending order or descending order (default). Relevant when resultType = articles.

Default value:  false
dataType  string | string[]

What data types should we search? news content (default, news), press releases (pr) or blogs (blog).

Available values:  news, pr, blog
Default value:  news
Returned Details 

The API call can return more or less meta-data information about the articles, concepts, categories, sources and locations. Click to see the available properties that can be specified to determine the amount of returned information.

articleBodyLen  integer

Set the size of the article body that'll be returned in the response. Use -1 for full article body.

Default value:  -1
includeArticleTitle  boolean

Set this parameter to true to include the article title in the response.

Default value:  true
includeArticleBasicInfo  boolean

Set this parameter to true to include the core article information in the response.

Default value:  true
includeArticleBody  boolean

Set this parameter to true to include the article body in the response.

Default value:  true
includeArticleEventUri  boolean

Set this parameter to true to include the uri of the event (to which the article belongs) in the response.

Default value:  true
includeArticleSocialScore  boolean

Set this parameter to true to include the information about how many times the article was shared on different social media.

Default value:  false
includeArticleSentiment  boolean

Set this parameter to true to include the article sentiment in the response (value will be non-null only for English articles).

Default value:  true
includeArticleConcepts  boolean

Set this parameter to true to include the article concepts in the response.

Default value:  false
includeArticleCategories  boolean

Set this parameter to true to include the article categories in the response.

Default value:  false
includeArticleLocation  boolean

Set this parameter to true to include the article location in the response.

Default value:  false
includeArticleImage  boolean

Set this parameter to true to include the article image in the response.

Default value:  true
includeArticleAuthors  boolean

Set this parameter to true to include the article authors in the response.

Default value:  true
includeArticleVideos  boolean

Set this parameter to true to include the article videos in the response.

Default value:  false
includeArticleLinks  boolean

Set this parameter to true to include the article links in the response.

Default value:  false
includeArticleExtractedDates  boolean

Set this parameter to true to include article extracted dates in the response.

Default value:  false
includeArticleDuplicateList  boolean

Set this parameter to true to include the list of duplicate articles in the response.

Default value:  false
includeArticleOriginalArticle  boolean

Set this parameter to true to include the original article in the response.

Default value:  false
includeSourceTitle  boolean

Set this parameter to true to include the source title in the response.

Default value:  true
includeSourceDescription  boolean

Set this parameter to true to include the source description in the response.

Default value:  false
includeSourceLocation  boolean

Set this parameter to true to include the source location in the response.

Default value:  false
includeSourceRanking  boolean

Set this parameter to true to include the source ranking in the response.

Default value:  false
includeConceptLabel  boolean

Set this parameter to true to include the concept label in the response.

Default value:  true
includeConceptImage  boolean

Set this parameter to true to include the concept image in the response.

Default value:  false
includeConceptSynonyms  boolean

Set this parameter to true to include the concept synonyms in the response.

Default value:  false
conceptLang  string

Define the language of the concept label.

Default value:  eng
includeCategoryParentUri  boolean

Set this parameter to true to include category parent uri in the response.

Default value:  false
includeLocationPopulation  boolean

Set to true to include the population size of the location.

Default value:  false
includeLocationGeoNamesId  boolean

Set to true to include the GeoNames id of the location.

Default value:  false
includeLocationCountryArea  boolean

Set to true to include the are of the location in squared km.

Default value:  false
includeLocationCountryContinent  boolean

Set to true to get the continent of the country for location objects.

Default value:  false