Skip to main content

REST API

Public routes use the namespace:

/wp-json/cliq-store-locator/v1

Search stores

GET /search accepts the principal parameters below. The server validates types and allowed values; clients should omit unknown values rather than sending partial strings.

ParameterMeaning
lat, lngSearch origin; supply both together
radiusPositive radius applied from the origin
unitkm or mi
page, per_pagePagination
qText query
city, countryLocation filters
categoryComma-separated category identifiers
brandBrand identifier
openOpen-now filter
sortdistance or name
langRequested language context
statusComma-separated allowed public statuses

Distance sort and radius require valid coordinates. Preserve the same full parameter set between page 1 and load-more requests.

Other public routes

GET /stores/slug/{slug}
GET /stores/{id}
GET /categories
GET /field-options
GET /templates
GET /templates/{id}
GET /forms
GET /forms/{id}
POST /leads
POST /events
POST /register
POST /preview

Public write routes validate and rate-limit requests. Do not assume a route is safe merely because it is public; clients must handle 4xx, 429, and server errors without exposing internals. The search limit is currently 120 requests per minute per applicable rate-limit identity and may change, so avoid request-per-keystroke behavior without debounce/cancellation.