Zernio
Zernio
API Reference

Products

List productsGETGet a productGETUpdate a productPATCH
Dashboard
llms.txtOpenAPI
OverviewPlatformsAPI ReferenceResources
Products

List products

Lists the products on the connected store in the platform's default order, each with its variants, options and images. Cursor-paginated: pass limit (1-50, default 20) and the cursor from a previous response's nextCursor; nextCursor is null when there are no more pages. Filter with status and/or query (the platform's product search syntax, e.g. title:*shirt* vendor:Acme tag:summer).

Supported on Shopify (platform shopify); accounts on other platforms return 400. A store connected before product access was added answers 403 insufficient_permissions until the merchant reconnects it through GET /v1/connect/shopify.

PlatformsShopify
GET
/v1/accounts/{accountId}/products

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Path Parameters

accountId*string

Connected Shopify SocialAccount id.

Query Parameters

limit?integer

Page size (1-50).

Range1 <= value <= 50
Default20
cursor?string

Opaque cursor from a previous response. Omit for the first page.

status?string

Only products in this status.

Value in

  • "active"
  • "draft"
  • "archived"
query?string

Platform product search syntax, passed through verbatim (Shopify: title, vendor, product_type, tag, sku, handle, created_at, updated_at, ...).

Lengthlength <= 500

Response Body

application/json

application/json

application/json

{  "platform": "shopify",  "products": [    {      "id": "string",      "platform": "shopify",      "title": "string",      "handle": "string",      "descriptionHtml": "string",      "vendor": "string",      "productType": "string",      "tags": [        "string"      ],      "status": "active",      "featuredImage": {        "url": "string",        "altText": "string"      },      "images": [        {          "url": "string",          "altText": "string"        }      ],      "options": [        {          "name": "string",          "values": [            "string"          ]        }      ],      "variants": [        {          "id": "string",          "title": "string",          "sku": "string",          "barcode": "string",          "price": "string",          "compareAtPrice": "string",          "inventoryQuantity": 0,          "availableForSale": true,          "selectedOptions": [            {              "name": "string",              "value": "string"            }          ]        }      ],      "seo": {        "title": "string",        "description": "string"      },      "totalInventory": 0,      "onlineStoreUrl": "string",      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z",      "publishedAt": "2019-08-24T14:15:22Z"    }  ],  "nextCursor": "string"}
Was this page helpful?

Delete a blog article

Deletes the article. The delete happens on the platform and is permanent; Zernio stores nothing to restore it from. Supported on Shopify (platform `shopify`). Accounts on platforms without blogs support return 400; a blogs-capable platform that lacks this specific operation returns 405.

Get a product

Fetches a single product with its variants, options and images. `productId` is the platform's numeric product id from `GET /v1/accounts/{accountId}/products`, not a Zernio id. Supported on Shopify (platform `shopify`); accounts on other platforms return 400.