Skip to main content
POST /stores/similar finds stores whose whole assortment resembles one or more stores you name. It compares the stores’ overall published profiles. When you name several stores, their profiles are averaged. The stores you name never appear in their own results. The response has the same shape as POST /stores/search.
Similar-store search covers the same stores as store search: stores with a published profile. Results can return fewer stores than limit, and there is no total or pagination.
This endpoint is not billed. It is rate limited like every /v1 route. Responses are sent with Cache-Control: private, no-store.

Request

Body parameters

Unknown fields return a 422.
string[]
required
1 to 10 store domains to find neighbors for, as GET /stores/{domain} takes them: bare hosts such as thereformation.com. Each store must be covered and have a published profile.
integer
default:"24"
Most stores to return, from 1 to 100.

Response

StoreSearchResult[]
required
Unique stores, most similar first. See POST /stores/search for the result fields. matchedDepartment is not populated for similarity results.

Errors

See the overview for authentication and rate-limit errors. Operation ID: searchSimilarStores. SDK methods: Python search_similar_stores(stores, limit=...); TypeScript searchSimilarStores({ stores, limit }). The CLI command is storerouter stores similar <domain|url>.... The MCP equivalent is similar_stores.