Skip to main content
GET
Get a Shopper's Recent Search Terms
Before calling this endpoint, make sure you’ve generated an API token and picked the correct domain. See Authentication & Base URLs.
This is the only Search endpoint that identifies the shopper with a query parameter (user_id) rather than a header. Results are capped at 50 regardless of limit.

Headers

x-tenant-id
string
required

Identifies your organization. Ensures data isolation per tenant.

x-workspace-id
string
required

Identifies the workspace within your organization. Scopes resources to a specific workspace.

x-environment-id
string
required

Identifies the environment you are targeting. Scopes the call to a specific deployment environment.

Query Parameters

catalog_id
string
required

Catalog to return recent searches for.

user_id
string

Shopper to return recent searches for.

limit
integer
default:5

Maximum number of terms to return. Hard-capped at 50 server-side.

Response

Success.

Response payload.