POST/people/search/scroll

Scroll

Search people with cursor-based pagination for large result sets. Accepts the same filters as /people/search. No 10,000 result limit unlike the standard search endpoint. 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.

Company Enrich·Dynamic pricing

Dynamic pricing

body.pageSize * 2 * 0.01225

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: "company-enrich",
  path: "/people/search/scroll",
  body: {
    "pageSize": "value"
  }
});

console.log(output);

Body parameters

pageSizerequired

integer

REQUIRED. Number of results per page (1-100). Determines cost: 2 credits ($0.0245) per result returned. Total call cost = pageSize x per-result cost.

cursor

string

The cursor to use for pagination. This is used for cursor based pagination. If this is set, Page will be ignored. For later cursor pages of the same logical search, keep non-pagination parameters unchanged and pass top-level parentRequestId from the first Orthogonal /v1/run response.

companyFilter

object

The filters to be applied on the companies to find people for

query

string

The search query to apply on the company name and domain

positionQuery

array

The list of search queries to apply on the person's current job position/title

atCurrentCompanyAfter

string

Filter by current company join date - only include people who joined after this UTC date

atCurrentCompanyBefore

string

Filter by current company join date - only include people who joined before this UTC date

atCurrentPositionAfter

string

Filter by current position start date - only include people who started after this UTC date

atCurrentPositionBefore

string

Filter by current position start date - only include people who started before this UTC date

exclude

object

Exclusion filters to apply on the people. If a person matches any of the filters here, it will be excluded from the results.

countries

array

The 2 letter country codes to filter by

domains

array

The domains to find people for. Up to 100 domains are allowed.

seniority

array

The seniorities to filter by

department

array

The departments to filter by

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.