Skip to navigation
aVenture APINews and ContentNews

List News Articles, Including a Company's or Person's News

View as Markdown

Browse recent news articles, newest published first unless sort says otherwise, with optional filtering. A company’s news is this list filtered by owner.entityId (CLI —owner-entity-id): under the default sort, articles whose headline names the company (brand or alias) and were published within a recent window lead, then newest first; explicit sorts and text search are unchanged. A person’s news is this list filtered by owner.personId (CLI —owner-person-id). This is the article list: the entities an article is about come from the semantic-similarity read, not here.

Query parameters

sizeintegerOptional>=1Defaults to 25

The size of the page to be returned; default and maximum 25 for the standard list, where larger values are reduced to that maximum. Explicit newsId selections instead accept up to 200 articles per page. Entity, person, author-initial, and thin-mode reads accept larger pages.

searchstringOptional

Full-text news search term.

categorystringOptional
News category slug to include or exclude.
owner.entityIdstringOptionalformat: "uuid"

Owning entity id; set only when personId is absent.

owner.personIdstringOptionalformat: "uuid"

Owning person id; set only when entityId is absent.

excludeIdintegerOptional
Exclude one news article by id.
publishedAfterdateOptional
Earliest publication date, inclusive.
publishedBeforedateOptional
Latest publication date, inclusive.
newsIdlist of integersOptional
Return only these news article ids.
pageintegerOptional>=0Defaults to 0

Zero-based page index (0..N)

sortlist of stringsOptional

Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

Response headers

X-Next-CursorstringOptional
Opaque continuation token when cursor traversal has another page.
X-RateLimit-Limitinteger

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-Remaininginteger

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-Resetinteger

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

OK
contentlist of objectsOptional
emptybooleanOptional
firstbooleanOptional
lastbooleanOptional
numberintegerOptional
numberOfElementsintegerOptional
pageableobjectOptional
sizeintegerOptional
sortobjectOptional
totalElementslongOptional
totalPagesintegerOptional

Errors

400
Bad Request Error
406
Not Acceptable Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error