GET/search

Search Results

Retrieve search results or queue a search for later retrieval. Supports Google engine with geotargeting by country, subdivision, and city. Returns structured SERP data. 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.

Massive Web·$0.0125 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: "joinmassive",
  path: "/search",
  query: {
    "terms": "example"
  }
});

console.log(output);

Query parameters

termsrequired

string

The broad or exact word or phrase to query

engine

string

Search engine (google)

serps

integer

Number of results pages (1-10, default 1)

size

integer

Results per page (0-100)

offset

integer

Initial results to skip For later offset pages of the same logical search, keep non-pagination parameters unchanged and pass top-level parentRequestId from the first Orthogonal /v1/run response.

device

string

Device name to emulate

uule

string

Proprietary encoded string for emulating search location

country

string

Two-letter ISO country code

subdivision

string

First-level subdivision code

city

string

City name

language

string

Language name or ISO code

display

string

Display language for the search interface

url

string

Encoded results page URL (up to 2047 chars); overrides other params

awaiting

string

Lazy features to wait for (ai, answers, ads); repeatable

expiration

integer

Cache expiration in days (0 disables)

callback

string

Encoded callback URL or SQS queue URL/ARN for async notification

mode

string

sync or async mode

format

string

Output format accepted by Massive: html or json. Defaults to html when omitted.

Response

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.