Developer API

Search and catalog APIs

Use scoped SmartyFind APIs for product search, suggestions, catalog operations, analytics and integration workflows.

SmartyFind / api · DEMO
1Prepare the source
2Configure the behavior
3Validate with real cases
Developer reference

Public API: search and suggestions

These examples use a store public key. The key identifies the store; a storeId field is not required in the body. Use only authorized domains.

01

Search with stock and price constraints

query is required. language supports ro, en, it, de and fr. inStock, priceMax, page and limit are separate fields; filters contains lists of attribute values.

POST https://smartyfind.com/api/v1/search
Content-Type: application/json
x-api-key: PUBLIC_STORE_API_KEY

{
  "query": "black shoes",
  "language": "en",
  "inStock": true,
  "priceMax": 150,
  "limit": 20,
  "page": 1
}
02

Suggestions for typed text

Send at least two characters and request no more than ten suggestions. Keep a previous query response separate from the shopper’s latest input.

POST https://smartyfind.com/api/v1/suggestions
Content-Type: application/json
x-api-key: PUBLIC_STORE_API_KEY

{
  "query": "sho",
  "language": "en",
  "limit": 5
}
03

Errors and credentials

401 may indicate an invalid key; 403 may indicate an access restriction. On 429, reduce request frequency and retry with backoff. Do not loop on rejected requests. Administrative operations do not use this public key.

SmartyFind

Make every product easier to find

Connect your catalog and see how intelligent search changes product discovery.

Start freeExplore the guide