POST/search

Google Search

Google Search - returns organic results, knowledge graph, people also ask, related searches, and sitelinks. Use for general web queries, fact-finding, and research. Pagination billing: call the first page normally and save billing.requestId from the Orthogonal /v1/run response. For later page, offset, or cursor calls on the same logical search, pass parentRequestId with unchanged non-pagination parameters. Valid continuation calls still get their own request IDs and quoted price, but are charged 0. Changing filters starts a new billable request.

Serper·$0.002 per call

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: "serper",
  path: "/search",
  body: {
    "q": "example"
  }
});

console.log(output);

Body parameters

qrequired

string

Search query

string

Country code (e.g. us, uk, de)

string

Language code (e.g. en, es, fr)

string

Restrict results to language (e.g. lang_en, lang_fr, lang_de)

string

Restrict results to country (e.g. countryUS, countryGB, countryDE)

num

number

Number of results (default 10, max 100)

page

number

Page number for pagination For later pages of the same logical search, keep non-pagination parameters unchanged and pass top-level parentRequestId from the first Orthogonal /v1/run response.

autocorrect

boolean

Enable autocorrect (default true)

tbs

string

Time filter (qdr:h=past hour, qdr:d=past day, qdr:w=past week, qdr:m=past month, qdr:y=past year)

location

string

Location name for localized results (e.g. "New York, NY")

safe

string

Safe search: "active" to filter explicit content, "off" to disable

Response

credits

number

organic.0.date

string

organic.0.link

string

organic.0.title

string

organic.0.snippet

string

organic.0.position

number

searchParameters.q

string

searchParameters.num

number

searchParameters.tbs

string

searchParameters.type

string

searchParameters.engine

string

searchParameters.autocorrect

boolean

priceCents

number

Actual Orthogonal credits charged for this /v1/run call. Accepted continuation pages are charged 0.

quotedPriceCents

number

Price this call would normally cost before continuation billing is applied.

billing.requestId

string

Unique Orthogonal request ID for this page or poll call. Save the first call requestId and pass it as parentRequestId on later pages.

billing.parentRequestId

string|null

Parent Orthogonal request ID when this call is a continuation of an earlier search.

billing.rootRequestId

string

Root Orthogonal request ID for the full logical search.

billing.continuation

boolean

True when this call was accepted as a continuation page or poll.

billing.billable

boolean

False for accepted continuation pages because they are not charged again.

billing.quotedPriceCents

number

Quoted price for this page or poll before continuation billing.

billing.chargedPriceCents

number

Actual credits charged for this page or poll. Accepted continuations return 0.

billing.aggregateChargedPriceCents

number

Total charged so far for the full logical search, including the first page and accepted continuations.