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./v1 route. Responses are sent with Cache-Control: private, no-store.
Request
Body parameters
Unknown fields return a422.
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.Response
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.