curl --request GET \
--url https://astreus.ai/api/v1/news/search \
--header 'X-API-KEY: <api-key>'import requests
url = "https://astreus.ai/api/v1/news/search"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://astreus.ai/api/v1/news/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://astreus.ai/api/v1/news/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://astreus.ai/api/v1/news/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://astreus.ai/api/v1/news/search")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://astreus.ai/api/v1/news/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"items": [
{
"id": 24572400,
"sourceCode": "MINT",
"sourceName": "Mint — Markets",
"sourceKind": "publisher_rss",
"displayPolicy": "headline_link",
"attribution": "Mint",
"headline": "Tax twist for OMC stocks: Indian Oil, BPCL, HPCL shares in 2 Nov focus after this decision by Govt on petrol, diesel",
"headlineKind": "source",
"snippet": null,
"url": "https://livemint.com/market/stock-market-news/tax-twist-for-omc-stocks-indian-oil-bpcl-hpcl-shares-in-2-nov-focus-after-this-decision-by-govt-on-petrol-diesel-11793531837968.html",
"publishedAt": "2026-11-01T12:11:32.000Z",
"observedAt": "2026-11-01T12:18:01.968Z",
"updatedAt": "2026-11-01T12:18:02.618Z",
"importance": 22,
"isFlash": false,
"tickers": [],
"primaryCik": null,
"formType": null,
"itemCodes": null,
"topics": [
"ASIA",
"ENERGY"
],
"clusterId": 140284,
"language": "en",
"publisher": null
},
{
"id": 24555806,
"sourceCode": "BSKY",
"sourceName": "Bluesky — official accounts",
"sourceKind": "social",
"displayPolicy": "headline_snippet",
"attribution": "Source: Bluesky",
"headline": "@theguardian.com: Rare short-necked oil beetle rediscovered in Wales after nearly 60 years",
"headlineKind": "source",
"snippet": null,
"url": "https://bsky.app/profile/theguardian.com/post/3mzandafu2y22",
"publishedAt": "2026-11-01T10:52:13.000Z",
"observedAt": "2026-11-01T10:52:14.053Z",
"updatedAt": "2026-11-01T10:52:16.013Z",
"importance": 31,
"isFlash": false,
"tickers": [],
"primaryCik": null,
"formType": null,
"itemCodes": null,
"topics": [
"ENERGY",
"SOCIAL_OFFICIAL"
],
"clusterId": 139724,
"language": "en",
"publisher": null
}
],
"nextCursor": 24555806
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}Search news
Full-text search over headline and snippet of the served tape, newest first. Accepts the feed’s narrowing filters. Paged: nextCursor (null when exhausted) is the before of the next page. An unknown topic or source code or a limit above 100 is a 400; an unknown cik is a 404.
curl --request GET \
--url https://astreus.ai/api/v1/news/search \
--header 'X-API-KEY: <api-key>'import requests
url = "https://astreus.ai/api/v1/news/search"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://astreus.ai/api/v1/news/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://astreus.ai/api/v1/news/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://astreus.ai/api/v1/news/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://astreus.ai/api/v1/news/search")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://astreus.ai/api/v1/news/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"items": [
{
"id": 24572400,
"sourceCode": "MINT",
"sourceName": "Mint — Markets",
"sourceKind": "publisher_rss",
"displayPolicy": "headline_link",
"attribution": "Mint",
"headline": "Tax twist for OMC stocks: Indian Oil, BPCL, HPCL shares in 2 Nov focus after this decision by Govt on petrol, diesel",
"headlineKind": "source",
"snippet": null,
"url": "https://livemint.com/market/stock-market-news/tax-twist-for-omc-stocks-indian-oil-bpcl-hpcl-shares-in-2-nov-focus-after-this-decision-by-govt-on-petrol-diesel-11793531837968.html",
"publishedAt": "2026-11-01T12:11:32.000Z",
"observedAt": "2026-11-01T12:18:01.968Z",
"updatedAt": "2026-11-01T12:18:02.618Z",
"importance": 22,
"isFlash": false,
"tickers": [],
"primaryCik": null,
"formType": null,
"itemCodes": null,
"topics": [
"ASIA",
"ENERGY"
],
"clusterId": 140284,
"language": "en",
"publisher": null
},
{
"id": 24555806,
"sourceCode": "BSKY",
"sourceName": "Bluesky — official accounts",
"sourceKind": "social",
"displayPolicy": "headline_snippet",
"attribution": "Source: Bluesky",
"headline": "@theguardian.com: Rare short-necked oil beetle rediscovered in Wales after nearly 60 years",
"headlineKind": "source",
"snippet": null,
"url": "https://bsky.app/profile/theguardian.com/post/3mzandafu2y22",
"publishedAt": "2026-11-01T10:52:13.000Z",
"observedAt": "2026-11-01T10:52:14.053Z",
"updatedAt": "2026-11-01T10:52:16.013Z",
"importance": 31,
"isFlash": false,
"tickers": [],
"primaryCik": null,
"formType": null,
"itemCodes": null,
"topics": [
"ENERGY",
"SOCIAL_OFFICIAL"
],
"clusterId": 139724,
"language": "en",
"publisher": null
}
],
"nextCursor": 24555806
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}Authorizations
Astreus API key (pk_live_...), created on the Developers page in the terminal. Also accepted as Authorization: Bearer pk_live_....
Query Parameters
Required. Search text (websearch syntax), at most 200 characters (longer is cut).
Items per page, 1–100, default 50; above 100 is a 400.
1 <= x <= 100Comma-separated tickers; items tagged with any of them.
Numeric CIK or platform key; items whose primary company or a tagged company entity is this issuer.
Comma-separated topic codes (see /news/topics); any of them.
Comma-separated source codes (see /news/sources); any of them.
Comma-separated source codes to hide (the UI's Markets view hides agency releases, social posts and GDELT links).
Comma-separated filing form types to hide (e.g. 4,144,SC 13G); rows without a form are kept.
1 to return flash (high-priority) items only; 0 (default) for all.
0, 1, true, false Minimum importance score 0–100.
0 <= x <= 100Load older: items published before item on the tape (by publication time, then id). Pass the previous response's nextCursor.