GET /news

This is a public query for FIRST News. It is not a replacement of the RSS syndication, but a simple way of fetching the same news information using the API standards.

No additional credentials are required to access this information. Due to the nature of this data, the API limits apply (the maximum allowed resultset is 10,000 objects. Use time-based pagination to fetch smaller datasets.

Repository Endpoint URL Credentials
FIRST API v1 https://api.first.org/data/v1/news Public

Additional Parameters

These parameters may also be added to the query string to filter the results:

Parameter Type Description
channel string Title of the news channel the news should be listed on. Each news item may be linked to more than one News Channel. See GET /channels.
link string News item URL. Items published at FIRST website do not contain the domain name.
before datetime ISO 8601 Formatted date. Returns only news older than the input. If the timezone is not specificed, it'll be considered UTC.
after datetime ISO 8601 Formatted date. Returns only news newer than the input. If the timezone is not specificed, it'll be considered UTC.
q string Free text search at the news title, summary and URL.

Limitations

Since this is a public query with a large potential dataset, the Excel format (.xlsx extension) is disabled.

Scope

There are no additional scopes listed for this query.

Preview (GET /news/id)

Previewing the news item (also fetches contents and the channels the news item was published) is enabled, by adding the id of the news item to the request pathname:

curl -X GET "https://api.first.org/data/v1/news/40557"

Response

The response contains a list of news items, similar to what you'd find in a RSS feed. Remember to encode the channel title:

The preview information of the first item of the above query: