If you would like to query for promotional offers against our API you can use the following call to search or browse through all available deals in our catalog. Our vouchers API and offers API will get you a list of discounts and vouchers from the networks. You can use this data to integrate promotional offers and discount vouchers into your website/app. Each of these offers have a start and an end date, a merchant and a program associated to them. You can even get the category and the subcategory of the offer and, of course, the network and the affiliate URL. What is more, an offer has an appealing title for the customers and a description that offers more details on that specific promotion. Our API can also be used for daily deals that have an expiration date of one day and can also be accompanied by images.
API Function: get_offers
| Name | Type | Description |
| username | string | Your API username. You should have received this with your account |
| subscription_id | string | Your Subscription ID. You can copy or regenerate it from your API management interface. |
| network_id | numeric | The ID of the desired affiliate network. You can use this parameter to get offers available on a specific network. Please read the Networks section to find out how to obtain a list of networks IDs. |
| merchant_id | numeric | The ID of the desired merchant. You can use this parameter to get offers provided by a specific merchant. To obtain a list of merchants please read the "Merchants" section. |
| category_id | numeric | The ID of the desired category. Use this to obtain offers belonging to a single category. To obtain a list of categories please read the "Categories" section. |
| country_id | numeric | You can use this parameter to query our catalog for offers available in a country. To obtain a list of countries please read the "Countries" section. |
| start_date / end_date | string | These parameters will allow you to filter results based on date. You can use these parameters to display offers who are valid between a set start and expiration date. You can input any date string accepted by PHP but we recomed you use the "Y-m-D H:i:s" format. |
| offer_type | string | Can be one of the following values {offer, code, daily_deal} . This parameter is used to filter the offers after their types |
| has_postback | numeric | This parameter is used to filter the offers . If you set it to 1 will be returned only offers which support postback reporting |
Response fields:
| Name | Type | Description |
| offer_id | numeric | The unique ID associated with the offer |
| country_id | numeric | The ID of the country in which this offer is active |
| merchant_id | numeric | The ID of the merchant who is supplying this offer |
| program_id | numeric | The ID of the merchant's affiliate program |
| category_id | numeric | The Category ID associated with the offer |
| subcategory_id | numeric | The Subcategory ID asociated eith the offer |
| network_id | numeric | The ID of the affiliate network who is supplying the offer |
| offer_title | string | Title |
| offer_description | string | Offer details |
| offer_start_date | string | Starting date |
| offer_end_date | string | Expiration date |
| offer_affiliate_url | string | The offer's URL. It can be a affiliate or direct link. |
| offer_voucher_code | string | If the offer has a voucher code associated with it, this field will display the code. |
| offer_price | numeric | Price of the offer |
| offer_discount | numeric | Offer Discount |
| offer_currency | string | Currency ID for the offer price |
| is_holiday_offer | string | Flag that says if the offer is a holiday offer |
| offer_large_img_url | string | Offer big image, used for daily deals offers |
| offer_location | string | national or local |
| offer_image | string | Offer small image, used for daily deals offers |
<?php
$api_username = '*******';
$api_subscription = '*******';
$api_network_id = 0; // replace with your network id
$api_merchant_id = 0; // replace with your country id
$api_category_id = 0; // replace with your category id
$api_country_id = 221; // replace with your country id
$api_start_date = ''; // replace with start date
$api_end_date = ''; // replace with end date
$api_offer_type = ''; // replace with offer type
$api_has_postback = 0; // replace with has postback
try
{
$client = new SoapClient('https://synced.io/api/v2?wsdl');
$offers = $client->get_offers($api_username, $api_subscription, $api_network_id, $api_merchant_id, $api_category_id, $api_country_id, $api_start_date, $api_end_date, $api_offer_type, $api_has_postback);
}
catch(Exception $e)
{
echo $e->getMessage();
}
if(!empty($offers))
{
print_r($offers);
}
?>