Search the news

The same recall with the clock turned up. Not a second search: it builds the same query and runs the same ranking, and differs in exactly three ways.

The freshness window defaults to a week rather than unbounded. An unbounded news search returns the best-ranked article on a subject, which is routinely years old.

Publishers can be filtered by list, with sources and exclude_sources.

sort_by=date is available and means what it says.

Sending category here is rejected rather than ignored, because overriding it silently would leave you believing the parameter did something.

POST

api

news

Search the news

curl --request POST \
  --url https://api.truscan.co/api/search/news \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "q": "<string>",
  "tier": "instant",
  "limit": 10,
  "enrich": true,
  "format": "json",
  "site": "<string>",
  "lang": "<string>",
  "category": "general",
  "structured": false,
  "sources": [
    "reuters.com",
    "apnews.com"
  ],
  "exclude_sources": [
    "<string>"
  ],
  "sort_by": "relevance"
}
'

import requests

url = "https://api.truscan.co/api/search/news"

payload = {
    "query": "<string>",
    "q": "<string>",
    "tier": "instant",
    "limit": 10,
    "enrich": True,
    "format": "json",
    "site": "<string>",
    "lang": "<string>",
    "category": "general",
    "structured": False,
    "sources": ["reuters.com", "apnews.com"],
    "exclude_sources": ["<string>"],
    "sort_by": "relevance"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    query: '<string>',
    q: '<string>',
    tier: 'instant',
    limit: 10,
    enrich: true,
    format: 'json',
    site: '<string>',
    lang: '<string>',
    category: 'general',
    structured: false,
    sources: ['reuters.com', 'apnews.com'],
    exclude_sources: ['<string>'],
    sort_by: 'relevance'
  })
};

fetch('https://api.truscan.co/api/search/news', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.truscan.co/api/search/news"

	payload := strings.NewReader("{\n  \"query\": \"<string>\",\n  \"q\": \"<string>\",\n  \"tier\": \"instant\",\n  \"limit\": 10,\n  \"enrich\": true,\n  \"format\": \"json\",\n  \"site\": \"<string>\",\n  \"lang\": \"<string>\",\n  \"category\": \"general\",\n  \"structured\": false,\n  \"sources\": [\n    \"reuters.com\",\n    \"apnews.com\"\n  ],\n  \"exclude_sources\": [\n    \"<string>\"\n  ],\n  \"sort_by\": \"relevance\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "success": true,
  "message": "Found 2 results.",
  "result": {
    "id": "srch_46b56d1ae8f127a8",
    "query": "how does TLS certificate pinning work",
    "tier": "instant",
    "total": 2,
    "format": "json",
    "results": [
      {
        "rank": 1,
        "url": "https://www.ssl.com/blogs/what-is-certificate-pinning/",
        "title": "What Is Certificate Pinning? - SSL.com",
        "snippet": "Certificate pinning is a security mechanism used in the context of authenticating client-server connections.",
        "domain": "ssl.com",
        "score": 0.6622,
        "components": {
          "consensus": 1,
          "position": 1,
          "lexical": 0.3553,
          "proximity": 0.5556,
          "authority": 0.5,
          "freshness": 0
        },
        "content": {
          "text": "What Is Certificate Pinning? Certificate pinning is a security mechanism...",
          "markdown": "## What Is Certificate Pinning?\n\nCertificate pinning is a security mechanism...",
          "excerpt": "What Is Certificate Pinning? SSL/TLS related content explaining the mechanism.",
          "words": 783,
          "lang": "en",
          "site_name": "SSL.com"
        }
      }
    ],
    "stats": {
      "took_ms": 2143,
      "recall_ms": 1152,
      "enrich_ms": 991,
      "candidates": 46,
      "deduped": 20,
      "enriched": 2,
      "cached": false
    }
  }
}

{
  "success": false,
  "message": "<string>",
  "result": {
    "code": "<string>"
  }
}

{
  "success": false,
  "message": "<string>",
  "result": {
    "code": "<string>"
  }
}

{
  "success": false,
  "message": "<string>",
  "result": {
    "code": "<string>"
  }
}

{
  "success": false,
  "message": "<string>",
  "result": {
    "code": "<string>"
  }
}

Body

application/json

query

string

required

Maximum string length: 512

string

Accepted as an alias for query.

tier

enum<string>

default:instant

Search depth, which sets how many pages one search reads: instant up to 10, deep up to 50, deep_reasoning up to 100. The budget is absolute rather than a multiple of limit, and a search never reads more pages than it recalled.

Available options:

instant,

fast,

auto,

deep,

deep_reasoning

limit

integer

default:10

Required range: 1 <= x <= 50

enrich

boolean

default:true

Fetch and extract page bodies for the top results. Off is roughly ten times faster and returns engine snippets only.

format

enum<string>

default:json

Available options:

json,

markdown,

text

site

string

Restrict to one host.

lang

string

freshness

enum<string>

Available options:

any,

day,

week,

month,

year

Response

Ranked results

success

boolean

message

string

result

object

Show child attributes

Last modified on September 24, 2026

⌘I

Search the news

curl --request POST \
  --url https://api.truscan.co/api/search/news \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "q": "<string>",
  "tier": "instant",
  "limit": 10,
  "enrich": true,
  "format": "json",
  "site": "<string>",
  "lang": "<string>",
  "category": "general",
  "structured": false,
  "sources": [
    "reuters.com",
    "apnews.com"
  ],
  "exclude_sources": [
    "<string>"
  ],
  "sort_by": "relevance"
}
'

import requests

url = "https://api.truscan.co/api/search/news"

payload = {
    "query": "<string>",
    "q": "<string>",
    "tier": "instant",
    "limit": 10,
    "enrich": True,
    "format": "json",
    "site": "<string>",
    "lang": "<string>",
    "category": "general",
    "structured": False,
    "sources": ["reuters.com", "apnews.com"],
    "exclude_sources": ["<string>"],
    "sort_by": "relevance"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    query: '<string>',
    q: '<string>',
    tier: 'instant',
    limit: 10,
    enrich: true,
    format: 'json',
    site: '<string>',
    lang: '<string>',
    category: 'general',
    structured: false,
    sources: ['reuters.com', 'apnews.com'],
    exclude_sources: ['<string>'],
    sort_by: 'relevance'
  })
};

fetch('https://api.truscan.co/api/search/news', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.truscan.co/api/search/news"

	payload := strings.NewReader("{\n  \"query\": \"<string>\",\n  \"q\": \"<string>\",\n  \"tier\": \"instant\",\n  \"limit\": 10,\n  \"enrich\": true,\n  \"format\": \"json\",\n  \"site\": \"<string>\",\n  \"lang\": \"<string>\",\n  \"category\": \"general\",\n  \"structured\": false,\n  \"sources\": [\n    \"reuters.com\",\n    \"apnews.com\"\n  ],\n  \"exclude_sources\": [\n    \"<string>\"\n  ],\n  \"sort_by\": \"relevance\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "success": true,
  "message": "Found 2 results.",
  "result": {
    "id": "srch_46b56d1ae8f127a8",
    "query": "how does TLS certificate pinning work",
    "tier": "instant",
    "total": 2,
    "format": "json",
    "results": [
      {
        "rank": 1,
        "url": "https://www.ssl.com/blogs/what-is-certificate-pinning/",
        "title": "What Is Certificate Pinning? - SSL.com",
        "snippet": "Certificate pinning is a security mechanism used in the context of authenticating client-server connections.",
        "domain": "ssl.com",
        "score": 0.6622,
        "components": {
          "consensus": 1,
          "position": 1,
          "lexical": 0.3553,
          "proximity": 0.5556,
          "authority": 0.5,
          "freshness": 0
        },
        "content": {
          "text": "What Is Certificate Pinning? Certificate pinning is a security mechanism...",
          "markdown": "## What Is Certificate Pinning?\n\nCertificate pinning is a security mechanism...",
          "excerpt": "What Is Certificate Pinning? SSL/TLS related content explaining the mechanism.",
          "words": 783,
          "lang": "en",
          "site_name": "SSL.com"
        }
      }
    ],
    "stats": {
      "took_ms": 2143,
      "recall_ms": 1152,
      "enrich_ms": 991,
      "candidates": 46,
      "deduped": 20,
      "enriched": 2,
      "cached": false
    }
  }
}

{
  "success": false,
  "message": "<string>",
  "result": {
    "code": "<string>"
  }
}

{
  "success": false,
  "message": "<string>",
  "result": {
    "code": "<string>"
  }
}

{
  "success": false,
  "message": "<string>",
  "result": {
    "code": "<string>"
  }
}

{
  "success": false,
  "message": "<string>",
  "result": {
    "code": "<string>"
  }
}

Search

Extract

Answer

Research

Crawl

Webhooks

Request logs

API keys

Search the news

Body

Response