API

By integrating this API, publishers can effortlessly retrieve and present these offers directly within their own user interface. This enables the development of fully native, personalized in-app experiences that align seamlessly with the app’s design and user journey driving higher user engagement and boosting conversion rates.

1. Authentication

All requests to the API require authentication using your API Key and APP ID .

1. Navigate to your Publisher Dashboard and select your App.

2. In the "Basic Info" tab, find the API Key section.

3. If you don't have an API key, click Request API Key and wait for approval.

4. Once approved, copy your API Key.

2. Endpoint

2.1 Example

<?php

$app_id = "YOUR_APP_ID";
$api_key = "YOUR_API_KEY";
$limit = 100;

$all_offers = [];
$current_page = 1;

do {
    $url = "https://targo.io/api/v1/offers/{$app_id}?limit={$limit}&page={$current_page}";

    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        "Authorization: Bearer {$api_key}",
        "Accept: application/json"
    ]);

    $response = curl_exec($ch);
    curl_close($ch);

    $data = json_decode($response, true);

    if (isset($data['success']) && $data['success'] === true) {
        $all_offers = array_merge($all_offers, $data['offers']);

        $total_pages = $data['total_pages'];
        $current_page++;
    } else {
        echo "Error fetching page {$current_page}
";
        break;
    }

} while ($current_page <= $total_pages);

echo "Successfully fetched " . count($all_offers) . " total offers!";

3. Query Parameters

All query parameters are optional and allow you to filter the inventory returned by the API. If no parameters are provided, the API will return all available offers for your App.

4. Pagination

The API implements standard pagination. The root of the JSON response contains the following simplified pagination properties:

• current_page: The current page number you are viewing.

• total_pages: The total number of pages available based on your limit.

• total_offers: The absolute total number of valid offers available across all pages.

• count: How many offers are returned in this specific response.

By passing ?page=2&limit=50, you can loop through the entire inventory seamlessly until current_page reaches total_pages.

5. Response Fields

6. Tracking Link

The tracking_url****included in the offers list is a securely generated, time-sensitive redirect link. The link is valid for 30 minutes if a user attempts to access it after that period, it will have expired.

6.1 Tracking Link Parameters

You can append data directly to the URL string provided in the JSON:

6.2 Example