LootLabs API Documentation

https://help.lootlabs.gg/en/category/api-documentation-1vutrk2
Admin
LootLabs API Documentation provides comprehensive guides and tools for developers to integrate...
Tokens:2,506
Snippets:21
Trust Score:7.4
Update:8 months ago
Show doc for...
Tokens:
Raw
### Create LootLabs Links using GET Request (API)

Source: https://help.lootlabs.gg/en/category/api-documentation-1vutrk2/index

This snippet shows how to create links using the LootLabs API via a GET request. It requires an API key for authentication and specifies the destination URL. The output is a generated link.

```bash
curl -X GET "https://lootlabs.gg/api/create?url=YOUR_DESTINATION_URL&apikey=YOUR_API_KEY"
```

--------------------------------

### LootLabs Link Creation API

Source: https://help.lootlabs.gg/en/category/api-documentation-1vutrk2/index

Documentation on how to use POST and GET requests to create links using your API key.

```APIDOC
## POST /api/links

### Description
Creates a new link using the LootLabs API.

### Method
POST

### Endpoint
/api/links

### Parameters
#### Query Parameters
- **apiKey** (string) - Required - Your LootLabs API key.

#### Request Body
- **destinationUrl** (string) - Required - The URL to which the link should redirect.

### Request Example
```json
{
  "destinationUrl": "https://example.com"
}
```

### Response
#### Success Response (200)
- **linkId** (string) - The unique identifier for the created link.
- **shortUrl** (string) - The generated short URL.

#### Response Example
```json
{
  "linkId": "lnk_12345abc",
  "shortUrl": "https://lootlabs.gg/xyz"
}
```

## GET /api/links

### Description
Retrieves a list of your created links.

### Method
GET

### Endpoint
/api/links

### Parameters
#### Query Parameters
- **apiKey** (string) - Required - Your LootLabs API key.

### Response
#### Success Response (200)
- **links** (array) - An array of link objects.
  - **linkId** (string) - The unique identifier for the link.
  - **shortUrl** (string) - The generated short URL.
  - **destinationUrl** (string) - The original destination URL.

#### Response Example
```json
{
  "links": [
    {
      "linkId": "lnk_12345abc",
      "shortUrl": "https://lootlabs.gg/xyz",
      "destinationUrl": "https://example.com"
    }
  ]
}
```
```

--------------------------------

### Postback API

Source: https://help.lootlabs.gg/en/category/api-documentation-1vutrk2/index

A system to ensure users have completed tasks, sending a GET request to your postback URL upon completion.

```APIDOC
## GET /postback

### Description
This endpoint is called by LootLabs when a user completes a task. It is used for tracking and verification.

### Method
GET

### Endpoint
/postback

### Parameters
#### Query Parameters
- **userId** (string) - The ID of the user who completed the task.
- **taskId** (string) - The ID of the task completed.
- **timestamp** (string) - The timestamp of task completion.
- **p** (string) - A unique identifier for the postback event, used for verification.

### Response
#### Success Response (200)
- **status** (string) - Indicates the success of the postback (e.g., 'success', 'failed').

#### Response Example
```json
{
  "status": "success"
}
```
```

--------------------------------

### Verify Task Completion with Postback API (API)

Source: https://help.lootlabs.gg/en/category/api-documentation-1vutrk2/index

This snippet explains how the Postback API works for verifying user task completion. When a task is completed, a GET request is sent to your specified postback URL, allowing for IP checking and reward system management.

```bash
https://your-postback-url.com?user_id=USER_ID&task_id=TASK_ID&ip=USER_IP
```

--------------------------------

### Create LootLabs Links using POST Request (API)

Source: https://help.lootlabs.gg/en/category/api-documentation-1vutrk2/index

This snippet demonstrates how to create links using the LootLabs API via a POST request. It requires an API key for authentication and specifies the destination URL. The output is a generated link.

```bash
curl -X POST https://lootlabs.gg/api/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "url=YOUR_DESTINATION_URL"
```

--------------------------------

### Integrate LootLabs Ads with Buttons (Vanilla JavaScript)

Source: https://help.lootlabs.gg/en/category/api-documentation-1vutrk2/index

This Vanilla JavaScript code snippet demonstrates integrating LootLabs ads into a website or Telegram Mini-App. It focuses on creating buttons that allow users to interact with ads, potentially leading to task completion and rewards.

```javascript
function createLootLabsAdButton(adId, onClick) {
  const button = document.createElement('button');
  button.textContent = 'View Ad';
  button.onclick = () => onClick(adId);
  return button;
}

// Usage:
// const button = createLootLabsAdButton('some_ad_id', handleAdClick);
// document.body.appendChild(button);
```

--------------------------------

### Redirect LootLabs Links using &data parameter (API)

Source: https://help.lootlabs.gg/en/category/api-documentation-1vutrk2/index

This snippet illustrates how to use the LootLabs Redirect API with the '&data' parameter to redirect links to new destinations. This is useful for anti-bypass measures.

```bash
https://lootlabs.gg/r?id=LINK_ID&data=NEW_DESTINATION_URL
```

--------------------------------

### Integrate LootLabs Ads with Buttons (React.js)

Source: https://help.lootlabs.gg/en/category/api-documentation-1vutrk2/index

This React.js code snippet shows how to integrate LootLabs ads into a website using buttons. Users can click these buttons to interact with ads, potentially triggering tasks and rewards.

```javascript
function LootLabsAdButton({
  adId,
  onClick
}) {
  return (
    <button onClick={() => onClick(adId)}>
      View Ad
    </button>
  );
}

// Usage:
// <LootLabsAdButton adId="some_ad_id" onClick={handleAdClick} />
```

--------------------------------

### Encrypt LootLabs Links using Redirect API (API)

Source: https://help.lootlabs.gg/en/category/api-documentation-1vutrk2/index

This snippet demonstrates how to encrypt links using LootLabs' Redirect API. This feature enhances link security and resistance to bypasses by encrypting the destination URL.

```bash
https://lootlabs.gg/r?id=LINK_ID&encrypted_data=ENCRYPTED_DESTINATION_URL
```

--------------------------------

### Fetch LootLabs Statistics using API Token (API)

Source: https://help.lootlabs.gg/en/category/api-documentation-1vutrk2/index

This snippet shows how to fetch reports and analytics from the LootLabs Statistics API. It requires an 'apitoken' for authentication and allows for data grouping, date range selection, and column filtering.

```bash
curl -X GET "https://lootlabs.gg/api/stats?apitoken=YOUR_API_TOKEN&group_by=day&date_from=YYYY-MM-DD&date_to=YYYY-MM-DD&columns=clicks,conversions"
```

--------------------------------

### LootLabs Redirect API (Anti-Bypass)

Source: https://help.lootlabs.gg/en/category/api-documentation-1vutrk2/index

Allows users to redirect their links to new destinations using the '&data' parameter, providing an anti-bypass mechanism.

```APIDOC
## POST /api/redirect/encrypt

### Description
Encrypts a link to provide an anti-bypass mechanism.

### Method
POST

### Endpoint
/api/redirect/encrypt

### Parameters
#### Query Parameters
- **apiKey** (string) - Required - Your LootLabs API key.

#### Request Body
- **destinationUrl** (string) - Required - The original destination URL.

### Request Example
```json
{
  "destinationUrl": "https://original-destination.com"
}
```

### Response
#### Success Response (200)
- **encryptedUrl** (string) - The encrypted URL resistant to bypasses.

#### Response Example
```json
{
  "encryptedUrl": "https://lootlabs.gg/encrypted?data=..."
}
```
```

--------------------------------

### LootLabs Statistics API

Source: https://help.lootlabs.gg/en/category/api-documentation-1vutrk2/index

Allows you to fetch reports and analytics related to your ad feeds using secure and structured requests.

```APIDOC
## GET /api/stats

### Description
Fetches reports and analytics for your ad feeds.

### Method
GET

### Endpoint
/api/stats

### Parameters
#### Query Parameters
- **apitoken** (string) - Required - Your LootLabs API token for authentication.
- **startDate** (string) - Optional - The start date for the report (e.g., YYYY-MM-DD).
- **endDate** (string) - Optional - The end date for the report (e.g., YYYY-MM-DD).
- **grouping** (string) - Optional - How to group the data (e.g., 'day', 'week', 'month').
- **columns** (string) - Optional - Comma-separated list of columns to retrieve (e.g., 'clicks,impressions').

### Response
#### Success Response (200)
- **report** (object) - An object containing the requested statistics.
  - **date** (string) - The date of the data point.
  - **clicks** (integer) - The number of clicks.
  - **impressions** (integer) - The number of impressions.
  - ... (other requested columns)

#### Response Example
```json
{
  "report": [
    {
      "date": "2023-10-27",
      "clicks": 150,
      "impressions": 1000
    }
  ]
}
```
```
Tokens:
Raw