QUICKSTART
API Quick Start
Authentication
SignString
Versioning
Rate Limit
Body Envelope
Request Errors
CHANGELOG
Changelog
Scenarios
Recommendations
Best Sellers
Bought Together
Complements
New Arrival
Random
Similar
Search
Semantic Search
Visual Search
Browse
Tagging
Product tagging
Reference
API Overview
Discoveries
Recommend products
post
Suggest product query
post
Search products
post
Predict product category and tags
post
Model
Envelope
Meta
v1
Error
v1
Pagination
v1
Primitive
Partial Product
Predict Tag
Predict Category
Tagging Product
ENUM
Filter key
Support
Contact Support

Suggest product query

post
/discoveries/suggest

Request

Headers

Content-Type
string
required

Content-Type

Allowed value:
application/json
Default:
application/json
as-store-id
string
required

The identifier of your Commerce store

Example:
f58a7bc4fb6d4719901906abde0c6f46

Body

query
string
required

The search query.

Example:
shir
session_id
string

Session unique identifier. It is recommended to use this package to generate UUID.

Example:
47be3249-c1f4-446d-b652-8749be6ed577
limit
number

The number of suggestions each page contains.

<= 20
Default:
10
Example:
5

Responses

200

Headers

as-api-version
string

The actual API version that serves the request

Example:
2025-01
as-trace-id
string

A UUID value without hyphens to trace and debug the request

Example:
5ae20644d52348a49a897fff5dd314a3

Body

meta
Meta
Example:
{"code":200,"type":"OK","message":"Everything worked as expected."}
code
number
required

A 1 to 5-digit integer that represents the status of the request.

Example:
200
message
string

A human-readable string message that gives a short description to the specific meta code.

type
string

A human-readable short string which is the type of HTTP status, e.g. OK for a 200 HTTP status, or BadRequest for a 400 HTTP status.

Allowed values:
OKBadRequestUnauthorizedForbiddenNotFoundUnprocessableEntityTooManyRequestsInternalError
errors
array[Error]
data
object
suggestion
object

Suggestion object.

Auth
:
Parameters
:
:
Body
{ "search": "shir", "session_id": "47be3249-c1f4-446d-b652-8749be6ed577", "limit": 5 }
Response Example
{
  "meta": {
    "code": 200,
    "type": "OK",
    "message": "Everything worked as expected."
  },
  "data": {
    "suggestion": {
      "texts": [
        "shirt",
        "shirt for women",
        "shirt dress",
        "shirt design",
        "shirt drawing"
      ]
    }
  }
}