Skip to main content
POST

Authorizations

Authorization
string
header
required

A Revcenter API key: Authorization: Bearer rvc_live_.... Keys are scoped, rate limited per key, and metered per workspace.

Headers

Idempotency-Key
string

Deduplicates the billing event when a request is retried. Safe to send on every call.

Required string length: 8 - 160

Body

application/json
query
string
required

The search query. q is accepted as an alias.

Minimum string length: 1
Example:

"site:linkedin.com/in wealth advisor San Jose CFP"

surface
enum<string>
default:search

Which search surface to query. endpoint and surface are interchangeable.

Available options:
search,
images,
news,
maps,
places,
videos,
shopping,
scholar,
patents,
autocomplete
endpoint
enum<string>
default:search

Which search surface to query. endpoint and surface are interchangeable.

Available options:
search,
images,
news,
maps,
places,
videos,
shopping,
scholar,
patents,
autocomplete
num
integer
default:10

Results per page. Requests of 10 or fewer bill at the shallow rate; more than 10 bills at the deep rate.

Required range: 1 <= x <= 100
page
integer
default:1
Required range: 1 <= x <= 50
gl
string

Country code, e.g. us.

Example:

"us"

hl
string

Language code, e.g. en.

Example:

"en"

location
string

Geographic location string passed through to the search provider.

idempotencyKey
string

Deduplicates billing when a request is retried. The Idempotency-Key header does the same thing.

Required string length: 8 - 160

Response

Search results.

The standard success envelope for billed endpoints.

data
object
meta
object