Search and rankings

Search results your application can reason about.

Retrieve marketplace search pages with products, organic and sponsored position, filters, and bounded pagination.

Why it matters

Context makes data usable.

Rank monitoring breaks when placement, sponsored results, and pagination are interpreted differently. Glade makes those decisions explicit and versioned.

REQUESTsearch · one successful unit

POST /api/graphql

operation: search
variables: {
  "searchTerm": "mechanical keyboard",
  "domain": "US",
  "page": 1
}

Position semantics

Organic and sponsored placement remain distinguishable in normalized results.

Bounded pagination

Pages and limits are validated before any provider work begins.

Consistent filters

Sort, price, rating, and condition values use documented enums.

Start with the contract, then verify with data.

Use the playground for a bounded live call, inspect freshness and request metadata, and move to production only after your fixture checks pass.

Open the playground