List creators that you have an active partnership with. Filter results by any of your Brand IDs.

Method: GET (paginated)

Parameters:

• “limit”
  • Maximum number of creators returned
  • Default value: 25
  • Maximum value: 100
• “cursor”
  • Cursor for pagination
• “brand_ids”
  • Comma-delimited list of Brand IDs to filter results on
  • IDs for brands can be obtained via the /brands endpoint and are included in reporting via the /reports endoint
  • Optional

Response:

{
  "creators": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "email": "string",
      "bio": "string",
      "partneredBrandIds": [
        "3fa85f64-5717-4562-b3fc-2c963f66afa6"
      ]
    }
  ],
  "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_SELLER_API_KEY"
const ENDPOINT = "<https://app.levanta.io/api/seller/v1/creators/active>"

let cursor;
const creators = [];

const parameters = new URLSearchParams();
parameters.set("limit", 50); // Get 50 creators per response
// Limit creators to those partnered with the given two brands
parameters.set("brand_ids", "2ffb8c24-4496-4c68-a4e7-4ab7a39c6b90,76685df2-4ea5-4af3-943c-22e7a90a949d");

while (cursor !== null) {
	const response = await fetch(`${ENDPOINT}?${parameters.toString()}`, {
		method: "GET",
		headers: {
			Authorization: `Bearer ${API_KEY}`
		}
	});
	const json = await response.json();
	creators.push(...json.creators);
	cursor = json.cursor;
	if (cursor) parameters.set("cursor", cursor);
}
console.log(creators);