List products

GET

/products/

curl --request GET \
  --url 'https://api.semantico.ai/api/v1/products/?locale=en-US&tasks=none&sorting=asc&order_by=date' \
  --header 'Authorization: Bearer <token>'

• Production

Returns a paginated list of parent and standalone products. Variants are exposed under /products/{id}/variants/.

Authorizations

• bearerAuth

Parameters

Query Parameters

locale

string

Example

en-US

Locale for name, description, and attributes. Defaults to the workspace default locale.

search

string

Matches barcode, sku, mpn, asin, and name.

brand

string

Substring match on a single brand.

brands

string

Filter by multiple brands (repeat or comma-separate).

category

string

Category UUID (includes descendants), or no_category.

tag

string

Tag IDs (repeatable). Use none for products without tags.

created_at_after

string format: date

created_at_before

string format: date

images

boolean

Require (true) or exclude (false) products with images.

tasks

string

Allowed values: none success not_generated

Filter by generation status.

product_list

string

Filter by product list code.

sorting

string

default: desc

Allowed values: asc desc

order_by

string

default: date

Allowed values: date task

Responses

200

Paginated products

Media typeapplication/json

object

count

integer

next

string | null format: uri

previous

string | null format: uri

results

Array

object

sku

string

barcode

EAN / barcode.

string

mpn

string

asin

string

brand

string

category

Human-readable category path, e.g. Root > Subcategory.

string

name

string

description

string

url

string format: uri

html_description

string

external_id

string

open_attributes

object

key

additional properties

any

crawl_configuration

object

reference_string

string

source_url

string format: uri

images

Array<object>

object

source_url

string format: uri

order

integer

metadata

object

key

additional properties

any

product_lists

Product list code values.

Array<string>

tags_to_update

Tag IDs.

Array<integer>

variants

Array<object>

None of these fields are strictly required, but uniqueness rules apply to sku, barcode, mpn, and asin.

object

sku

string

barcode

EAN / barcode.

string

mpn

string

asin

string

brand

string

category

Human-readable category path, e.g. Root > Subcategory.

string

name

string

description

string

url

string format: uri

html_description

string

external_id

string

open_attributes

object

key

additional properties

any

crawl_configuration

object

reference_string

string

source_url

string format: uri

images

Array<object>

object

source_url

string format: uri

order

integer

metadata

object

key

additional properties

any

product_lists

Product list code values.

Array<string>

tags_to_update

Tag IDs.

Array<integer>

variants

Array<object> recursive

id

integer

is_product_model

boolean

created_at

string format: date-time

sections

Custom attributes for the product.

Array<object>

object

key

additional properties

any

Example^generated

{
  "count": 1,
  "next": "https://example.com",
  "previous": "https://example.com",
  "results": [
    {
      "sku": "example",
      "barcode": "example",
      "mpn": "example",
      "asin": "example",
      "brand": "example",
      "category": "example",
      "name": "example",
      "description": "example",
      "url": "https://example.com",
      "html_description": "example",
      "external_id": "example",
      "open_attributes": {},
      "crawl_configuration": {
        "reference_string": "example",
        "source_url": "https://example.com"
      },
      "images": [
        {
          "source_url": "https://example.com",
          "order": 1
        }
      ],
      "metadata": {},
      "product_lists": [
        "example"
      ],
      "tags_to_update": [
        1
      ],
      "variants": [],
      "id": 1,
      "is_product_model": true,
      "created_at": "2026-04-15T12:00:00Z",
      "sections": [
        {}
      ]
    }
  ]
}

401

Missing or invalid token.

Media typeapplication/json

object

detail

string

Example^generated

{
  "detail": "example"
}