Pages Search

POST

/intent/pages/search

• Production
• QA

Text / semantic / hybrid search across the intent-enriched page index.

Honors the same operator syntax the internal search box supports: site:<domain>, intitle:X, inurl:X, type:blog, audience:b2b, -exclude, or just a bare domain for domain-mode.

Authorizations

• BearerAuth

Parameters

Header Parameters

X-Target-Org-Id

Any of:

string

string

null

null

Request Body ^required

object

filters

Any of:

object

object

key

additional properties

any

null

null

include_visitors

boolean

default: true

limit

integer

default: 50 >= 1 <= 500

offset

integer

query

required

string

>= 1 characters <= 500 characters

semantic_ratio

0 = text, 1 = semantic, between = hybrid

number

<= 1

sort

Any of:

Array<string>

Array<string>

null

null

Responses

200

Successful Response

object

data

required

object

filtered_no_visitors

Hits hidden because they had no visitors in the lookback window (include_visitors=true). total_hits counts them; pages does not.

integer

mode

string

default: text

pages

Array<object>

default:

object

audience

Any of:

string

string

null

null

commercial_score

Any of:

number

number

null

null

domain_root

Any of:

string

string

null

null

mention_score

Any of:

number

number

null

null

page_type

Any of:

string

string

null

null

summary

Any of:

string

string

null

null

title

Any of:

string

string

null

null

url

Any of:

string

string

null

null

visitors

Any of:

integer

integer

null

null

query

required

string

scope_note

Any of:

string

string

null

null

took_ms

integer

total_hits

integer

visitors_error

Any of:

string

string

null

null

warnings

Non-fatal problems: visitor counts timed out or failed (pages are then returned unfiltered, visitors=null), every hit was hidden by the has-visitors filter, or the search backend failed.

Array<string>

pagination

Any of:

PaginationMeta

object

has_next

required

Whether there are more pages

boolean

limit

required

Items per page

integer

next_cursor

Any of:

string

string

null

null

notes

Any of:

Array<string>

Array<string>

null

null

page

required

Current page number (1-indexed)

integer

total

required

Total number of items

integer

total_available

Any of:

integer

integer

null

null

total_is_lower_bound

Any of:

boolean

boolean

null

null

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string