GET
/v1/search/full
v1Full-text search with entity matching
Advanced full-text search that combines FTS results with entity-matched articles. Automatically detects entity names in the query and merges relevant articles from those entities.
Parameters
| Name | Type | Description |
|---|---|---|
q required | string | Search query e.g. John Roberts climate ruling |
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. John Roberts climate ruling
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/full?q=John%20Roberts%20climate%20ruling&limit=10&offset=0" \
-H "Authorization: Bearer nrf_your_api_key"Response
json
{
"results": [
{
"url_hash_hex": "a1b2c3d4e5",
"title": "Supreme Court Rules on Landmark Climate Case",
"source_name": "Reuters",
"category": "politics",
"published_at_ms": 1708300800000,
"discovered_at_ms": 1708301400000,
"image_url": "string",
"placeholder_image_url": "string",
"snippet": "The Supreme Court issued a landmark ruling...",
"rank": 12.5
}
],
"total": 42
}Try it
Server
Using sandbox demo key (5 req/min) — no signup required
Authentication
Demo key (sandbox)
Endpoint
GET /v1/search/full
Default: 20
Default: 0