Get affiliate link

This endpoint lets you monetize links in the content of your project. Take API replaces the direct link with the affiliate link if an offer from the advertiser is found for it in Takeads catalog.

You can test this API endpoint and inspect the possible responses using Swagger UI.

Request

URL: https://api.takeads.com/v1/product/monetize-api/v2...

Method: PUT

Request headers

Request body

A request body must contain the required

parameter. Optionally, you can specify a SubID for the tracking link to be received, and request a link to the advertisers' logo.

Context-Type: application/json

Request examples

•       curl --request PUT \ --url https://api.takeads.com/v1/product/monetize-api/v2/resolve
        \
        --header 'Authorization: Bearer <Public Key>' \ --header 'Content-Type:
        application/json' \ --data '{ "iris": ["https://example.com/"] } '
  	

•       fetch("https://api.takeads.com/v1/product/monetize-api/v2/resolve", {
       "method": "PUT",
        "headers": {
        "Content-Type": "application/json",
        "Authorization": "Bearer <Public Key>"
        },
        "body": "{\"iris\":[\"https://example.com/\"]}"
        })
        .then(response => {
        console.log(response);
        })
        .catch(err => {
        console.error(err);
        });
  	

• $curl = curl_init();
        curl_setopt_array($curl, [
        CURLOPT_URL => "https://api.takeads.com/v1/product/monetize-api/v2/resolve",
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_ENCODING => "",
        CURLOPT_MAXREDIRS => 10,
        CURLOPT_TIMEOUT => 30,
        CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
        CURLOPT_CUSTOMREQUEST => "PUT",
        CURLOPT_POSTFIELDS => "{\n\t\"iris\": [\n\t\t\"https://example.com/\"\n\t]\n}\n",
        CURLOPT_HTTPHEADER => [
        "Authorization: Bearer <Public Key>",
        "Content-Type: application/json"
        ],
        ]);
        $response = curl_exec($curl);
        $err = curl_error($curl);
        curl_close($curl);
        if ($err) {
        echo "cURL Error #:" . $err;
        } else {
        echo $response;
        }
  	

•       import http.client
        conn = http.client.HTTPSConnection("api.takeads.com")
        payload = "{\n\t\"iris\": [\n\t\t\"https://example.com/\"\n\t]\n}\n"
        headers = {
        'Content-Type': "application/json",
        'Authorization': "Bearer <Public Key>"
        }
        conn.request("PUT", "/v1/product/monetize-api/v2/resolve", payload, headers)
        res = conn.getresponse()
        data = res.read()
        print(data.decode("utf-8"))
  	

Response

If the request was successfully processed by the server, the HTTP response with 200 status code is returned.

The response payload is a JSON object that contains a data array. Each item of the array is an object with the IRI, affiliated link, and link to the advertiser's logo (if requested).

The following table describes the response properties.

After receiving the tracking link, you can modify it to include additional parameters.

The following table describes the tracking link parameters.

If an offer from the advertiser is not found in Takeads catalog, an empty array is returned in the response.

Example value

{
    data: [
        {
            iri: 'https://example-one.de/item/1005003993360501.html',
            trackingLink: 'https://tatrck.com/h/Q1w2e3R4T5y6?url=https://examplelink.com&s=product_subid,
            imageUrl: 'https://mtusimg.de/logos_v2/90x45/7f5c65985ea0f99602873287fb19602e.gif'
        },
        {
            iri: 'https://www.example-two.de/',
            trackingLink: 'https://tatrck.com/h/Q1w2e3R4T5y6?url=https://examplelink.com&s=product_subid,
            imageUrl: 'https://mtusimg.de/logos_v2/90x45/d4c4f0c0e5fe9da6493fd975d82e7abf.gif'
        }
    ]
}

To view possible error responses, refer to the Error responses article.