ASasknews
distribution

Get the top N articles by metric for domains

Changed on

Get the top N domain articles ranked by the selected metric.

get/v1/distribution/articles/top_n_for_domains

Request

Query parameters

domain_namesstring[] required

Domain names to filter by

limitinteger

Number of top domain articles to return (page size)

pageinteger

Page number (1-based; page size = limit)

start_dateinteger nullable

Start date to filter by (timestamp in seconds since epoch)

end_dateinteger nullable

End date to filter by (timestamp in seconds since epoch)

metric'surface' | 'citation' | 'grounded'

Metric used to rank and count the returned articles

Response

A list of top domain articles with raw counts for the selected ranking metric

total_countinteger required
pageinteger
next_pageinteger nullable

Changes