Search or list top headlines from the last 24 hours
Returns the highest trend_score articles from the past 24 hours — a narrow window on getTrendingArticles.
When to use: breaking news, daily briefings, or "what is hot today" without a custom date range.
Note: from is not accepted; the 24h window is fixed server-side.
Filters (all optional): same semantics as getTrendingArticles except no date override.
Related tools: getTrendingArticles (7-day window), searchArticles.
query Parameters
qOptional semantic search query (3–512 chars).
accMatch strictness when q is set. Default 0.75.
content_typeRestrict to content kind: news or blog.
tagsFuzzy filter across categories+regions+entities (AND between values).
categoriesExact topic filter (OR).
regionsExact region filter (OR).
entitiesExact entity filter (OR).
sourcesPublisher source ID filter (OR).
full_contentInclude full article body. Default false.
limitPage size. Default 16, max 128.
offsetSkip N results. Default 0.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Search or list top headlines from the last 24 hours › Responses
Top headlines from last 24h sorted by trend_score descending
urlURL is the canonical URL of the article or post.
titleTitle is the human-readable headline or title of the content.
summarySummary is a short abstract or teaser used in listings and previews.
contentContent is the full body text when the source content is available.
content_typeKind is the content type, for example news, blog, post, generated, or comment.
authorAuthor is the byline or attributed creator when available from the source.
image_urlImageUrl is the featured image or preview image associated with the content.
sourceSource is the canonical publisher identifier and matches Publisher.Source.
categoriesCategories lists the inferred topics assigned to the content.
regionsRegions lists geographic regions mentioned in or associated with the content.
entitiesEntities lists named entities such as people, places, organizations, or products.
tagsComputed tags merged from categories/regions/entities for display
published_atCreated is the original publish timestamp of the article or post.
likesLikes is the aggregate number of likes or upvotes associated with this Bean.
commentsComments is the aggregate number of replies or comments associated with this Bean.
sharesShares is the aggregate number of reposts or share-like actions associated with this Bean.
subscribersSubscribers is the aggregate audience size associated with this Bean's chatter. Not populated on current list endpoints.
relatedRelated is the count of semantically or editorially related Beans.
trend_scoreTrendScore is the computed ranking score used to order trending results. Returned by top-headlines and trending; not returned by search.
sentimentsSentiments lists inferred tones or sentiments expressed in the content.
Search or list newest articles (reverse chronological)
Returns recently published articles sorted by publish date (newest first).
Time window: if from is omitted, defaults to the last 7 days.
Filters (all optional): same semantics as searchArticles — q for semantic search, tags for fuzzy match, or exact categories/regions/entities/sources.
When to use: monitoring recent news in a topic without full-corpus search cost. Lighter than searchArticles.
Related tools: listCategories, listEntities, listRegions, searchArticles, getTrendingArticles.
query Parameters
qOptional semantic search query (3–512 chars). Narrows results by embedding similarity.
accMatch strictness when q is set. Default 0.75.
content_typeRestrict to content kind: news or blog.
tagsFuzzy filter across categories+regions+entities (AND between values).
categoriesExact topic filter (OR). Use listCategories for valid values.
regionsExact region filter (OR). Use listRegions for valid values.
entitiesExact entity filter (OR). Use listEntities for valid values.
sourcesPublisher source ID filter (OR).
fromPublished on/after this date (YYYY-MM-DD). Defaults to 7 days ago when omitted.
full_contentInclude full article body. Default false.
limitPage size. Default 16, max 128.
offsetSkip N results. Default 0.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Search or list newest articles (reverse chronological) › Responses
Latest articles sorted by published_at descending
urlURL is the canonical URL of the article or post.
content_typeKind is the content type, for example news, blog, post, generated, or comment.
titleTitle is the human-readable headline or title of the content.
summarySummary is a short abstract or teaser used in listings and previews.
contentContent is the full body text when the source content is available.
authorAuthor is the byline or attributed creator when available from the source.
sourceSource is the canonical publisher identifier and matches Publisher.Source.
image_urlImageUrl is the featured image or preview image associated with the content.
published_atCreated is the original publish timestamp of the article or post.
categoriesCategories lists the inferred topics assigned to the content.
regionsRegions lists geographic regions mentioned in or associated with the content.
entitiesEntities lists named entities such as people, places, organizations, or products.
tagsComputed tags merged from categories/regions/entities for display
sentimentsSentiments lists inferred tones or sentiments expressed in the content.
Search or list trending articles by engagement score
Returns articles ranked by trend_score (highest first). Trend score blends social engagement (likes, comments, shares), cross-outlet coverage, and recency.
Time window: if from is omitted, defaults to the last 7 days of trending activity.
Filters (all optional): same semantics as searchArticles.
When to use: surface what is gaining traction now — prefer over getLatestArticles when popularity matters more than recency alone.
Related tools: getTopHeadlines (24h subset), searchArticles, getArticlePropagation.
query Parameters
qOptional semantic search query (3–512 chars).
accMatch strictness when q is set. Default 0.75.
content_typeRestrict to content kind: news or blog.
tagsFuzzy filter across categories+regions+entities (AND between values).
categoriesExact topic filter (OR).
regionsExact region filter (OR).
entitiesExact entity filter (OR).
sourcesPublisher source ID filter (OR).
fromTrending activity since this date (YYYY-MM-DD). Defaults to 7 days ago when omitted.
full_contentInclude full article body. Default false.
limitPage size. Default 16, max 128.
offsetSkip N results. Default 0.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Search or list trending articles by engagement score › Responses
Articles with engagement metrics and trend_score, sorted descending
urlURL is the canonical URL of the article or post.
titleTitle is the human-readable headline or title of the content.
summarySummary is a short abstract or teaser used in listings and previews.
contentContent is the full body text when the source content is available.
content_typeKind is the content type, for example news, blog, post, generated, or comment.
authorAuthor is the byline or attributed creator when available from the source.
image_urlImageUrl is the featured image or preview image associated with the content.
sourceSource is the canonical publisher identifier and matches Publisher.Source.
categoriesCategories lists the inferred topics assigned to the content.
regionsRegions lists geographic regions mentioned in or associated with the content.
entitiesEntities lists named entities such as people, places, organizations, or products.
tagsComputed tags merged from categories/regions/entities for display
published_atCreated is the original publish timestamp of the article or post.
likesLikes is the aggregate number of likes or upvotes associated with this Bean.
commentsComments is the aggregate number of replies or comments associated with this Bean.
sharesShares is the aggregate number of reposts or share-like actions associated with this Bean.
subscribersSubscribers is the aggregate audience size associated with this Bean's chatter. Not populated on current list endpoints.
relatedRelated is the count of semantically or editorially related Beans.
trend_scoreTrendScore is the computed ranking score used to order trending results. Returned by top-headlines and trending; not returned by search.
sentimentsSentiments lists inferred tones or sentiments expressed in the content.
Search all articles by topic, tags, or URL
Primary MCP tool — full-corpus search sorted by relevance.
Requires at least one of: q, tags, categories, regions, entities, or urls.
Search modes (combinable with filters):
q+acc: semantic vector search over article embeddings (natural language, 3–512 chars).tags: fuzzy text match across categories, regions, and entities (AND between tag values; case/whitespace insensitive).categories/regions/entities: exact array filters (OR within each dimension; case/whitespace sensitive — discover values via listCategories, listEntities, listRegions).urls: fetch specific articles by canonical URL (CSV). Performance: scans the full index; preferfull_content=falseunless the body is needed. Heavier than feed endpoints. Related tools: listCategories, listEntities, listRegions, getPublishers, getArticlePropagation.
query Parameters
qSemantic search query in natural language (3–512 chars). Ranks by embedding similarity.
accMatch strictness when q is set. 0.0=broad, 1.0=strict. Default 0.75.
content_typeRestrict to content kind: news or blog.
urlsFetch articles by exact URL (CSV). Satisfies the required-search-param rule on its own.
tagsFuzzy filter across categories+regions+entities (AND between values). Good when exact tag spelling is unknown.
categoriesExact topic filter (OR). Case sensitive — use listCategories first.
regionsExact region filter (OR). Case sensitive — use listRegions first.
entitiesExact entity filter (OR). Case sensitive — use listEntities first.
sourcesPublisher source ID filter (OR). Resolve names via getPublishers.
fromOnly articles published or updated on/after this date (YYYY-MM-DD).
full_contentInclude full article body. Default false (summary only).
limitPage size. Default 16, max 128.
offsetSkip N results for pagination. Default 0.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Search all articles by topic, tags, or URL › Responses
Articles with publisher info and engagement metrics (likes, comments, shares, related); does not include trend_score
urlURL is the canonical URL of the article or post.
titleTitle is the human-readable headline or title of the content.
summarySummary is a short abstract or teaser used in listings and previews.
contentContent is the full body text when the source content is available.
content_typeKind is the content type, for example news, blog, post, generated, or comment.
authorAuthor is the byline or attributed creator when available from the source.
image_urlImageUrl is the featured image or preview image associated with the content.
sourceSource is the canonical publisher identifier and matches Publisher.Source.
source_base_urlBaseURL is the publisher's primary site URL copied onto aggregate results for convenience.
source_descriptionDescription is the publisher description copied onto aggregate results.
source_faviconFavicon is the publisher favicon URL copied onto aggregate results.
source_site_nameSiteName is the human-readable name of the publisher copied onto aggregate results.
categoriesCategories lists the inferred topics assigned to the content.
regionsRegions lists geographic regions mentioned in or associated with the content.
entitiesEntities lists named entities such as people, places, organizations, or products.
tagsComputed tags merged from categories/regions/entities for display
published_atCreated is the original publish timestamp of the article or post.
likesLikes is the aggregate number of likes or upvotes associated with this Bean.
commentsComments is the aggregate number of replies or comments associated with this Bean.
sharesShares is the aggregate number of reposts or share-like actions associated with this Bean.
subscribersSubscribers is the aggregate audience size associated with this Bean's chatter. Not populated on current list endpoints.
relatedRelated is the count of semantically or editorially related Beans.
trend_scoreTrendScore is the computed ranking score used to order trending results. Returned by top-headlines and trending; not returned by search.
sentimentsSentiments lists inferred tones or sentiments expressed in the content.
Track how articles spread (GET)
For each seed article URL, returns cross-outlet republication (coverage) and social/forum mentions (mentions).
Input: pass up to 128 article URLs as comma-separated query param urls.
When to use: after searchArticles — measure whether a story was picked up elsewhere or discussed on social platforms.
Returns: one PropagationResult per input URL (always HTTP 200; empty arrays when no propagation found).
Related tools: searchArticles, getTrendingArticles.
query Parameters
urlsSeed article URLs to analyze (CSV, 1–128 valid HTTP(S) URLs)
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Track how articles spread (GET) › Responses
One result object per input URL with coverage and mentions arrays
Track how articles spread (POST)
Same as getArticlePropagation but accepts a JSON body — preferred when URLs contain characters awkward in query strings.
Input: JSON body { "urls": ["https://...", ...] } with 1–128 valid HTTP(S) URLs.
When to use: batch propagation lookup from agent workflows that already hold URL lists in JSON.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Track how articles spread (POST) › Request Body
urlsURLs lists seed article URLs to analyze for cross-outlet coverage and social mentions (1–128 items).
Track how articles spread (POST) › Responses
One result object per input URL with coverage and mentions arrays