Creator API
      Back to home
      1. Knowledge Base
      2. Levanta API Documentation
      3. Creator API

      More Details on the Creator API

      Prerequisites

      To gain access to the Levanta Creator API you must have completed the following steps:

      1. Gained access to a creator account by either:

        1. Creating a creator account at app.levanta.io/auth/sign-up
        2. Being invited to a creator account by a team member

      2. Gained API access by requesting an API key via our in-app chat bot located in the lower-right corner of your screen when signed in

        1. It may take up to a week to be granted access to the api
        2. After being granted an api key you can access it here when signed in as an admin for your creator team 

      Playground

      Access Swagger documentation where you can test out the endpoints here (must be signed in).

      Authorization

      All requests to the Creator API must be made with an API key. You can check if you have an API key here when logged into an admin account.

      All requests made to https://app.levanta.io/api/creator/v1 should be made with the Authorization header set to “Bearer <API-Key>”

      Pagination

      All of our paginated endpoints use cursor-based pagination and accept a parameter named “cursor”. The first call to the endpoint can omit “cursor”. Every call to an endpoint will return “cursor” in its JSON response which should be passed as the value for “cursor” in the next call. If there are no more items to paginate through cursor will be returned as null.

      Endpoint Documentation

      GET:

      POST:

      Benefits of the Levanta API for Publishers

      The Levanta API unlocks a host of advantages for publishers, affiliates, and creators, including:

      1. Streamlined Integration: Integrate your existing technology with Levanta, instantly opening up hundreds of thousands of promotional opportunities via direct partnerships with Amazon Sellers.
      2. Customizable Reporting: Get access to tailored performance reports, offering insights into clicks, conversions, estimated sales, and estimated commissions for each link. With this data, you can better understand and optimize your promotional strategies.
      3. Simplified Product Discovery: The API’s extensive filtering options make it easier than ever to discover relevant products from your partnered brands, streamlining your affiliate opportunity discovery process.
      4. Link Creation & Management: Unlock a host of uses cases with programmatic access to affiliate link creation and management.

      Levanta API Key Features

      1. Active Brands Endpoint (/partners): Discover brand names and IDs with whom you have active partnerships. This feature allows you to easily navigate through your brand connections, ensuring you stay up to date with current collaborations.
      2. Product Catalog Endpoint (/products): Access the Levanta product catalog, sorting by title, commission, or price. The API enables you to filter by ASINs, brand IDs, access, minimum/maximum commission, and stock availability, streamlining your product search and selection process.
      3. Product and Link Reporting Endpoints (/reports): Stay informed on your link performance and product reports within a given date range, filtering by ASINs, sources, and brand IDs. This API functionality provides you with valuable insights into your marketing performance, allowing you to make data-driven decisions for optimizing your promotional efforts.
      4. Link Creation and Management Endpoints (/links): Easily create and manage your unique tracking links by ASIN/source pairs and filter by asin/source/adGroupId.

       

      Example of a Common API Integration

      Below is an example of how publisher partners typically integrate via the Levanta API:

      • Run a scheduled job that uses our GET /products endpoint (with access=true) to maintain a database of all Levanta ASINs. “access=true” ensures you are getting a list of ASINs you have access to by being part of the brand’s program
      • Whenever a new Amazon link is found on your platform or site/s, check the ASIN against your Levanta ASIN database
      • When matches are identified, use our POST /links endpoint to create your unique Levanta link
      • You can utilize the Source functionality to segment ASIN performance at a more granular level (e.g. per platform, site, or article). By passing an ID to the Source field, the API will return a unique link for that specific ASIN-Source combination
      • Use our GET /reports endpoint to get daily performance reports per unique link/source. This will include clicks, add-to-carts, conversions, sales, and commissions

      Note:

      • Make sure to check for “access=true” for the /products endpoint to avoid pulling in ASINs you do not have access to yet
      • Make sure to occasionally check if your links have been disabled, or set up a webhook to keep track of them
      • Be careful when modifying link parameters in any way as it can easily break tracking

      When might this be the best solution for you?

      • This works best for affiliates, publishers, and creators who prefer a dynamic and automated process of ASIN matching, link creation, and reporting
      • If you have numerous ASINs to monetize through Levanta and you don’t already work with tech partners (see below), this is the most scalable and seamless option