Get offer’s information

HTTP method Endpoint
GET /aff/v1/offers

Path parameters

Parameter Description
all All offers.
personal Personal offers.

Query string parameters

Conditions Parameters Type Description
type type type Possible Values:
all · personal
Offset offset offset Check page scale.
Limit limit limit The number of date displays in each page. Maximum = 200
Sort sort sort Ranking according to the specified field ascending "+", or descending "-".Only id sorting is supported.
Filters filters filter Query requirements of Specify field.
EQUAL_TO
NOT_EQUAL_TO
LESS_THAN
LESS_THAN_OR_EQUAL_TO
GREATER_THAN
GREATER_THAN_OR_EQUAL_TO
Fields fields field You can choose the field of the query (the result of the query is in line with the selected field).
id integer A string that uniquely identifies this offer.
name string The name of the this Offer
end_date integer The expiration date of the Offer.
status string The current status of the offer.
pricing_type string The current pricing_type of the offer.
Possible Values:
CPA · CPI · CPC · CPS · CPA+CPS
payout string The payout of the offer.
percent_payout string Percent payout.
preview_url string URL that often skips any geo-targeting or other re-targeting implemented by the Offer URL. Allows Affiliates to view sample landing page.
thumbnail string The offer’s thumbnail of the link address.
category string The category of the offer (categroy means the tag information).
offer_approval integer Whether this Offer requires manual approval before an Affiliate can run it.
Possible Values:
1 Require Approval
2 Public
3 Private
tracking_link string Tracking link.
NOTE: tracking link can be acquired only in the case of Personal Offer.
currency string The currency of the Offer.
VBT object Volume based payout tiers of this offer.
conversion_protocol integer The Conversion tracking method to use for the Offer.
Possible Values:
1:Image Pixel;
2:Postback URL;
3:iFrame Pixel
app_id string the App ID on app store or google play
event object Offer event.
Contains contains string List of related objects to return with each result.
description string A description for the Offer. Default does not return, if needed, by the following ways. For example,contains=description
EPC1 string Offers can be pulled according to EPC, for example,contains=EPC1,EPC1 means offers is pulled according to EPC of today
EPC2 string EPC2 means offers is pulled according to EPC of yesterday
EPC3 string EPC3 means offers is pulled according to EPC of last three days
EPC4 string EPC4 means offers is pulled according to EPC of last 7 days
CR1 string Offers can be pulled according to CR, for example,contains=CR1,CR1 means offers is pulled according to CR of today
CR2 string CR2 means offers is pulled according to CR of yesterday
CR3 string CR3 means offers is pulled according to CR of last three days
CR4 string CR4 means offers is pulled according to CR of last 7 days

Response body parameters

Field Type Description
id integer A string that uniquely identifies this offer.
name string The name of the this Offer
end_date integer The expiration date of the Offer.
status string The current status of the offer.
pricing_type string The current pricing_type of the offer.
Possible Values:
CPA·CPI·CPC·CPS
payout string The payout of the offer.
preview_url string URL that often skips any geo-targeting or other re-targeting implemented by the Offer URL. Allows Affiliates to view sample landing page.
description string A description for the Offer.
thumbnail string The offer’s thumbnail of the link address.
category string The category of the offer.
offer_approval integer Whether this Offer requires manual approval before an Affiliate can run it.
tracking_link string Tracking link.
NOTE: tracking link can be acquired only in the case of Personal Offer.
currency string The currency of the Offer.
VBT object Volume based payout tiers of this offer.
conversion_protocol integer The Conversion tracking method to use for the Offer.
Possible Values:
1:Image Pixel;
2:Postback URL;
3:iFrame Pixel
event object Offer event.
impression_pixel string impression pixel.
NOTE: impression_pixel link can be acquired only in the case of Personal Offer.
carrier array Mobile Carrier
app_id string the App ID on app store or google play
browser array Browser
totalPages integer The list of data pages (associated with your limit).
totalRows integer Total number of available data.
offset integer The number of records from a collection to skip. Iterating over large collections with this parameter can be slow.
limit integer The number of data displayed on one page.

Example request

Request GET https://{networkname}.api.offerslook.com/aff/v1/offers?type=all&sort=+id&limit=10&offset=2&filters[id][GREATER_THAN]=10


Request GET http://{networkname}.api.offerslook.com/aff/v1/offers?type=all&sort=+id&limit=10&offset=2&filters[id][GREATER_THAN]=10


Example response


    {
      "code": 0,
      "message": "Success",
      "data": {
        "rowset": [
          {
            "id": 15,
            "category": "test",
            "offer_approval": 2,
            "tracking_link": "http://click.dev.offerslook.com:9080/index.php?offer_id=15&aff_id=161",
            "end_date": 1493999999,
            "pricing_type": "CPA",
            "payout": "1",
            "percent_payout": "-1",
            "preview_url": "https://www.offerslook.com/",
            "currency": "USD",
            "conversion_protocol": 2,
            "app_id": "871125783",
             "impression_pixel": "<img src='http://qoqololo.iuniontrack.com:9080/impr.php?offer_id=15&aff_id=161'  border='0'  width='1'  height='1' />",
             "carrier": [],
              "browser": [
                    "Chrome",
                    "360 Browser",
                    "Amaya"
                ],
            "event": [
              {
                "event_id": 1,
                "event_name": "Initial Event",
                "event_payout_type": "CPA",
                "event_payout": "1.000",
                "event_percent_payout": "-1",
                "conversion_protocol": 2
              },
              {
                "event_id": 2,
                "event_name": "TEST",
                "event_payout_type": "CPA+CPS",
                "event_payout": "2.000",
                "event_percent_payout": "10",
                "conversion_protocol": 3
              }
            ]
          },
          {
            "id": 17,
            "category": "test",
            "offer_approval": 1,
            "tracking_link": "",
            "end_date": 1493999999,
            "pricing_type": "CPS",
            "payout": "-1",
            "percent_payout": "2",
            "preview_url": "https://www.offerslook.com/",
            "currency": "USD",
            "conversion_protocol": 2,
            "event": [
              {
                "event_id": 1,
                "event_name": "Initial Event",
                "event_payout_type": "CPS",
                "event_payout": "-1",
                "event_percent_payout": "2",
                "conversion_protocol": 2
              }
            ]
          },
          {
            "id": 18,
            "category": "test",
            "offer_approval": 1,
            "tracking_link": "",
            "end_date": 1493999999,
            "pricing_type": "CPC",
            "payout": "2",
            "percent_payout": "-1",
            "preview_url": "https://offerslook.gitbooks.io/api-documentation/content/index.html",
            "currency": "USD",
            "conversion_protocol": 1,
            "event": [
              {
                "event_id": 1,
                "event_name": "Initial Event",
                "event_payout_type": "CPC",
                "event_payout": "2",
                "event_percent_payout": "-1",
                "conversion_protocol": 2
              }
            ]
          }
        ],
        "totalPages": 2,
        "totalRows": 13,
        "offset": 2,
        "limit": 10
      }
    }

results matching ""

    No results matching ""