Get a Brand

Returns a single brand based on the ID supplied

Get a Brand

Retrieve detailed information about a specific affiliate brand by its ID. This endpoint provides comprehensive brand data including commission rates, available channels, and brand details.

HTTP Request

GET https://api-beta.lomadee.com.br/affiliate/brands/{id}

Path Parameters

id · string

The unique identifier of the brand to retrieve

Example Requests

Basic Request

curl -X GET "https://api-beta.lomadee.com.br/affiliate/brands/e36f5bbb-3e5f-42e2-be4c-6c32dac101c2" \
  -H "x-api-key: your-api-key"

Response Format

data · object

Brand object with detailed information

meta · object

Response metadata

Show properties

total · integer

Total number of results (always 1 for single brand)

page · integer

Current page number

limit · integer

Number of items per page

totalPages · integer

Total number of pages

Brand Object Structure

id · string

The unique identifier of the brand

logo · string

The logo URL of the brand

name · string

The name of the brand

slug · string

The URL-friendly slug of the brand

site · string

The website URL of the brand

commission · object

Commission information for the brand

Show properties

value · number

Commission percentage value (e.g., 4.2 for 4.2%)

transfer · string

Commission transfer type (e.g., “cpa” for Cost Per Action)

channels · array

Available affiliate channels for the brand

Show properties

id · string

Channel identifier

name · string

Channel name

availableChannel · object

Available channel information

Show properties

id · string

Available channel identifier

name · string

Available channel name

shortUrls · array

Shortened URLs for the channel

message · string

Restriction message if channel has limitations

Example Response

{
  "data": {
    "id": "e36f5bbb-3e5f-42e2-be4c-6c32dac101c2",
    "logo": "https://example.com/logo.png",
    "name": "Example Brand",
    "slug": "example-brand",
    "site": "https://example.com",
    "commission": {
      "value": 4.2,
      "transfer": "cpa"
    },
    "channels": [
      {
        "id": "channel-1",
        "name": "Main Channel",
        "availableChannel": {
          "id": "available-1",
          "name": "Available Channel"
        },
        "shortUrls": ["https://lomadee.com/short-url-1"],
        "message": null
      },
      {
        "id": "channel-2",
        "name": "Secondary Channel",
        "availableChannel": {
          "id": "available-2",
          "name": "Secondary Available Channel"
        },
        "shortUrls": ["https://lomadee.com/short-url-2"],
        "message": null
      }
    ]
  },
  "meta": {
    "total": 1,
    "page": 1,
    "limit": 1,
    "totalPages": 1
  }
}

Error Responses

404 Not Found

{
  "message": "Brand not found",
  "error": "NotFound",
  "statusCode": 404
}

401 Unauthorized

{
  "message": "API key is required",
  "error": "Unauthorized",
  "statusCode": 401
}

500 Internal Server Error

{
  "message": "Internal server error",
  "error": "InternalServerError",
  "statusCode": 500
}

Usage Examples

JavaScript/Node.js

const axios = require("axios");

async function getBrand(brandId) {
  try {
    const response = await axios.get(
      `https://api-beta.lomadee.com.br/affiliate/brands/${brandId}`,
      {
        headers: {
          "x-api-key": "your-api-key",
        },
      }
    );

    console.log("Brand:", response.data.data);
    console.log("Commission:", response.data.data.commission);
    console.log("Channels:", response.data.data.channels);
  } catch (error) {
    console.error("Error:", error.response.data);
  }
}

// Usage
getBrand("e36f5bbb-3e5f-42e2-be4c-6c32dac101c2");

Python

import requests

def get_brand(brand_id):
    url = f'https://api-beta.lomadee.com.br/affiliate/brands/{brand_id}'
    headers = {'x-api-key': 'your-api-key'}

    response = requests.get(url, headers=headers)

    if response.status_code == 200:
        data = response.json()
        brand = data['data']
        print('Brand:', brand['name'])
        print('Commission:', brand['commission'])
        print('Channels:', brand['channels'])
    else:
        print('Error:', response.json())

# Usage
get_brand("e36f5bbb-3e5f-42e2-be4c-6c32dac101c2")

PHP

<?php
function getBrand($brandId) {
    $url = "https://api-beta.lomadee.com.br/affiliate/brands/{$brandId}";
    $headers = ['x-api-key: your-api-key'];

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($httpCode === 200) {
        $data = json_decode($response, true);
        $brand = $data['data'];
        echo 'Brand: ' . $brand['name'] . "\n";
        echo 'Commission: ' . print_r($brand['commission'], true) . "\n";
        echo 'Channels: ' . print_r($brand['channels'], true) . "\n";
    } else {
        echo 'Error: ' . $response;
    }
}

// Usage
getBrand("e36f5bbb-3e5f-42e2-be4c-6c32dac101c2");
?>

Best Practices

1. Error Handling: Always handle 404 errors for invalid brand IDs
2. Caching: Cache brand data when appropriate (TTL: 60 seconds)
3. Commission Calculation: Use commission data to calculate potential earnings
4. Channel Validation: Check channel availability before generating links
5. Rate Limiting: Respect the 10 requests per minute limit

Common Use Cases

• Brand Details: Display detailed information about a specific brand
• Commission Analysis: Analyze commission rates for specific brands
• Channel Management: Check available channels for a specific brand
• Link Generation: Generate affiliate links for a specific brand
• Performance Tracking: Monitor performance metrics for individual brands

Authorizations

x-api-key · string · header · required

Path Parameters

id · integer · required

ID of brand to return

Response

200

application/json

Brand response

data · object

Show child attributes

meta · object

Show child attributes