List active products in Levanta's product catalogue. Filter products by ASIN, brand, access, and in stock status.

Method: GET (paginated)

Parameters:

• “limit”
  • Maximum number of products returned per page
  • Default value: 100
  • Maximum value: 250
• “cursor”
  • Cursor for pagination
• “asins”
  • Comma-delimited list of ASIN’s to filter results on
  • Optional
• “brand_ids”
  • Comma-delimited list of brand IDs to filter results on
  • IDs for brands can be obtained via the /brands endpoint
  • Optional
• “in_stock”
  • Possible values: “true”, “false”
    • “true” will paginate through products that are in stock
    • “false” will paginate through products that are out of stock
  • Optional
• “access”
  • Possible values: “true”, “false”
    • “true” will paginate through products that you have access to
    • “false” will paginate through products that you don’t have access to
  • Optional
  • A creator has access to a product if there is an active partnership between the creator and the brand that the product belongs to. /links can only be created for products that a creator has access to.
• “marketplace”
  • Marketplace filter

Response:

{
  "products": [
    {
      "asin": "string",
      "marketplace": "amazon.com",
      "pricing": {
        "price": 0,
        "currency": "USD"
      },
      "commission": 0,
      "title": "string",
      "inStock": true,
      "category": "string",
      "brandId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "access": true,
      "image": "string"
    }
  ],
  "cursor": "string" | null
}

Errors:

• 400: Bad Request
  • Parameters incorrectly formatted or exceed maximum values
• 401 Unauthorized
  • Invalid or omitted API key

Example:

const API_KEY = "LEVANTA_API_KEY";
const ENDPOINT = "<https://app.levanta.io/api/creator/v1/products>";

let cursor;
const products = [];

// Set up query parameters
const parameters = new URLSearchParams();
// Get 50 products per response
parameters.set("limit", 50);
// Limit products to two brands by brand ID, comma-delimited
parameters.set("brand_ids", "2ffb8c24-4496-4c68-a4e7-4ab7a39c6b90,76685df2-4ea5-4af3-943c-22e7a90a949d");
 // Only products under brands with an active partnership
parameters.set("access", "true");

// Paginate through products, stop when a value of null is returned for "cursor"
while (cursor !== null) {
    const response = await fetch(`${ENDPOINT}?${parameters.toString()}`, {
			method: "GET",
			headers: {
				Authorization: `Bearer ${API_KEY}`
			}
		});
	  const json = await response.json();
		// Store products returned
	  products.push(...json.products);
    cursor = json.cursor;
    if (cursor) parameters.set("cursor", cursor);
}
console.log(products);