emfasemfas

List products

Returns a paginated list of products with their attributes.

GET
/products

Authorization

Authorization<token>

API key authentication using Bearer token format. Use: Bearer

In: header

Query Parameters

updated_after?string

Returns products whose response data has changed since this timestamp (RFC3339), including descendant variant or SKU changes

search?string

JSON search filters keyed by attribute key — see filtering reference

search_mode?string

Filter match mode

Default"\"all\""
Value in"all" | "any"
include?string

Relations to embed (skus requires variants); metaobjects sideloads referenced metaobjects under included

attributes?string

Exact attribute keys or trailing-* selectors to return

exclude_attributes?string

Exact attribute keys or trailing-* selectors to omit after inclusion

completeness_profile?string

Completeness profile identifier to filter by

completeness?string

Completeness level, requires completeness_profile

Value in"complete" | "incomplete"
channel?string

Channel identifier completeness is evaluated against, defaults to the default channel

limit?integer

Results per page

Default100
Range1 <= value <= 200
page?integer

Page number (1-based)

Default1
Range1 <= value

Response Body

curl -X GET "https://api.emfas.ai/v1/products?updated_after=string&search=string&search_mode=all&include=string&attributes=string&exclude_attributes=string&completeness_profile=string&completeness=complete&channel=string&limit=100&page=1"
{
  "included": [
    {
      "attributes": {
        "property1": [
          {
            "data": null,
            "isMulti": false,
            "locale": "en-US",
            "metaobjectDefinition": "gender",
            "type": "text",
            "value": "Space Black"
          }
        ],
        "property2": [
          {
            "data": null,
            "isMulti": false,
            "locale": "en-US",
            "metaobjectDefinition": "gender",
            "type": "text",
            "value": "Space Black"
          }
        ]
      },
      "definition": "brand",
      "identifier": "nike",
      "name": "Nike",
      "type": "metaobject",
      "updatedAt": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "limit": 100,
    "page": 1,
    "totalPages": 3,
    "totalResults": 234
  },
  "result": [
    {
      "attributes": {
        "property1": [
          {
            "data": null,
            "isMulti": false,
            "locale": "en-US",
            "metaobjectDefinition": "gender",
            "type": "text",
            "value": "Space Black"
          }
        ],
        "property2": [
          {
            "data": null,
            "isMulti": false,
            "locale": "en-US",
            "metaobjectDefinition": "gender",
            "type": "text",
            "value": "Space Black"
          }
        ]
      },
      "identifier": "PROD-001",
      "name": "iPhone 14 Pro",
      "selfUpdatedAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z",
      "variants": [
        {
          "attributes": {
            "property1": [
              {
                "data": null,
                "isMulti": false,
                "locale": "en-US",
                "metaobjectDefinition": "gender",
                "type": "text",
                "value": "Space Black"
              }
            ],
            "property2": [
              {
                "data": null,
                "isMulti": false,
                "locale": "en-US",
                "metaobjectDefinition": "gender",
                "type": "text",
                "value": "Space Black"
              }
            ]
          },
          "identifier": "VAR-001",
          "name": "Small",
          "selfUpdatedAt": "2024-01-15T10:30:00Z",
          "skus": [
            {
              "attributes": {
                "property1": [
                  {
                    "data": null,
                    "isMulti": false,
                    "locale": "en-US",
                    "metaobjectDefinition": "gender",
                    "type": "text",
                    "value": "Space Black"
                  }
                ],
                "property2": [
                  {
                    "data": null,
                    "isMulti": false,
                    "locale": "en-US",
                    "metaobjectDefinition": "gender",
                    "type": "text",
                    "value": "Space Black"
                  }
                ]
              },
              "identifier": "SKU-001",
              "name": "Small-Blue",
              "selfUpdatedAt": "2024-01-15T10:30:00Z",
              "updatedAt": "2024-01-15T10:30:00Z"
            }
          ],
          "updatedAt": "2024-01-15T10:30:00Z"
        }
      ]
    }
  ]
}
{
  "error": "Internal server error"
}
{
  "error": "Internal server error"
}
{
  "error": "Internal server error"
}