GET/

Search the web

Search the web and get structured results. Returns ranked results with titles, snippets, and URLs. Supports location/language targeting, domain include/exclude filters, date range filters, and search types (web, news, research_paper).

TinyFish·Free

Example code

// Using @orth/sdk - The simplest way to call APIs
// Install: npm install @orth/sdk
import Orthogonal from "@orth/sdk";

const orthogonal = new Orthogonal({
  apiKey: process.env.ORTHOGONAL_API_KEY,
});

const output = await orthogonal.run({
  api: "tinyfish/search",
  path: "/",
  query: {
    "query": "example"
  }
});

console.log(output);

Query parameters

queryrequired

string

Search query (1-2000 chars)

purpose

string

Why this search is being run. Used to better rank results against your intent.

location

string

Country code for geo-targeted results (e.g. US, GB, DE)

language

string

Language code for result language (e.g. en, es, de)

include_domains

string

Comma-separated list of domains to restrict results to

exclude_domains

string

Comma-separated list of domains to exclude from results

domain_type

string

Type of search: web (default), news, or research_paper

after_date

string

Return results after this date (YYYY-MM-DD)

before_date

string

Return results before this date (YYYY-MM-DD)

recency_minutes

integer

Return results from the past N minutes (1-5256000)

pub_year_min

integer

Min publication year for research_paper type (0-9999)

pub_year_max

integer

Max publication year for research_paper type (0-9999)

page

integer

Page number for pagination, starting from 0 (max 10)

include_thumbnail

string

When true, results include thumbnail_url when available