GET
/v1/search
v1Search articles
Full-text search across all articles. Returns matching articles sorted by relevance.
Parameters
| Name | Type | Description |
|---|---|---|
q required | string | Search query e.g. climate change legislation |
limit | integer | Number of results to return Default: 20 e.g. 10 |
offset | integer | Number of results to skip Default: 0 e.g. 0 |
q required stringSearch query
e.g. climate change legislation
limit integerNumber of results to return
Default: 20
e.g. 10
offset integerNumber of results to skip
Default: 0
e.g. 0
Request Examples
bash
curl "https://api.newsrank.ai/v1/search?q=climate%20change%20legislation&limit=10&offset=0" \
-H "Authorization: Bearer nrf_your_api_key"Response
json
{
"items": [
{
"id": 48210,
"url_hash": "a1b2c3d4e5",
"title": "Supreme Court Rules on Landmark Climate Case",
"url": "https://example.com/article/supreme-court-climate",
"source_id": 12,
"source_name": "Reuters",
"category": "politics",
"published_at": 1708300800000,
"discovered_at": 1708301400000,
"excerpt": "The Supreme Court issued a landmark ruling today on...",
"image_url": "https://example.com/images/court.jpg",
"content_status": "has_content",
"headline_summary": "Supreme Court sides with environmental regulators",
"slug": "supreme-court-rules-on-landmark-climate-case"
}
],
"total": 83
}Try it
Server
Using sandbox demo key (5 req/min) — no signup required
Authentication
Demo key (sandbox)
Endpoint
GET /v1/search
Default: 20
Default: 0