List brands. Filter by access to see which brands you are partnered with.

Method: GET (paginated)

Parameters:

• “limit”
  • Maximum number of brands returned
  • Default value: 25
  • Maximum value: 100
• “cursor”
  • Cursor for pagination
• “access”
  • Possible values: “true”, “false”
    • “true” will paginate through brands with an active partnership
    • “false” will paginate through brands without an active partnership
  • Optional
• “marketplace”
  • Marketplace filter

Response:

{
  "brands": [
    {
      "brandId": "string",
      "brandName": "string",
      "bio": "string",
      "image": "string",
      "access": true,
      "url": "string",
      "marketplace": "amazon.com"
    }
  ],
  "cursor": "string"
}

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/brands>";

let cursor;
const brands = [];

// Set up query parameters
const parameters = new URLSearchParams();
parameters.set("limit", 50); // Get 50 brands per response
parameters.set("access", "true"); // Only brands with active partnership

// Paginate through brands, 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 brands returned
	  brands.push(...json.brands);
    cursor = json.cursor;
    if (cursor) parameters.set("cursor", cursor);
}
console.log(brands);