We present to you a great API to access the functionality of the Giftmio extension
With its help, you will be able to build cashback into your extension and monetise it profitably
Apply for API access
Implemented 3 api for webmasters to use them in the extension - campaign catalogue, api to search for cashback links and api to find out if the user is registered. Authorisation by token which is issued personally for webmaster.

In the extension you need to generate for each user a unique uuid v4 and pass it to the link.

  1. Advertisers catalog - GET
https://giftmio.com/api/extension/v1/<uuid>/catalog/ You can optionally transmit parameters limit, offset, search, country . Examples for a user with uuid="790402d2-0406-45fb-88d0-d06a8eb520d8":

without filters:

curl --request GET \
  --url https://giftmio.com/api/extension/v1/790402d2-0406-45fb-88d0-d06a8eb520d8/catalog/ \
  --header 'authorization: Token <token>'
with filter:

curl --request GET \
  --url 'https://giftmio.com/api/extension/v1/790402d2-0406-45fb-88d0-d06a8eb520d8/catalog/?limit=10&offset=20&country=DE&country=FR' \
  --header 'authorization: Token <token>'
or search:

curl --request GET \
  --url 'https://giftmio.com/api/extension/v1/790402d2-0406-45fb-88d0-d06a8eb520d8/catalog/?search=allegro' \
  --header 'authorization: Token <token>'
responds:

{
	"count": 28967,
	"next": "http://giftmio.com/api/extension/v1/790402d2-0406-45fb-88d0-d06a8eb520d8/catalog/?limit=15&offset=15",
	"previous": null,
	"limit": 15,
	"offset": 0,
	"results": [
		{
			"offer_id": "7a470a38-06ed-4efc-a71e-7a78be1729cc",
			"name": "OneTravel",
			"image": "https://cdn.giftmio.com/offer/29081-f6c74a279c495249.svg",
			"link": "https://giftmio.com/offer/onetravel/",
			"traffic_url": "https://rzekl.com/g/ndskfhsx7d3f495cd53ff212f8373f/?subid=790402d2-0406-45fb-88d0-d06a8eb520d8",
			"cashback_size": "12.5 USD",
			"countries": [
				"CA",
				"US"
			],
			"domains": [
				"onetravel.com"
			]
		},
        ...
    ]
}
offer_id - internal identificator in giftmio
link - ссылка на карточку кампании в giftmio
traffic_url - affiliate link for user с uuid="790402d2-0406-45fb-88d0-d06a8eb520d8"
countries - countries where the campaign works, sometimes we can't define and there will be an empty list or ‘00’ means all countries
domains - merchant domains
2. Cashback search through links - POST
https://giftmio.com/api/extension/v1/<uuid>/mass_search/ you can pass a list of links for which you want to find cashbacks and affiliate these links, example:

curl --request POST \
  --url https://giftmio.com/api/extension/v1/790402d2-0406-45fb-88d0-d06a8eb520d8/mass_search/ \
  --header 'Content-Type: application/json' \
  --header 'authorization: Token <token>' \
  --data '{
	"urls": [
		"https://www.nike.sa/en/metcon-1-og/NKFQ1854-C.html",
		"https://allegro.pl/oferta/kfd-premium-creatine-500-g-kreatyna-monohydrat-zielone-jablko-15745249131"
	]
}'
In the response for each link we try to find a cashback campaign, the campaign parameters are the same as in the catalogue, only in the traffic_url there will also be a diplink to the link that was used for the search:

[
	{
		"url": "https://www.nike.sa/en/metcon-1-og/NKFQ1854-C.html",
		"offer": null
	},
	{
		"url": "https://allegro.pl/oferta/kfd-premium-creatine-500-g-kreatyna-monohydrat-zielone-jablko-15745249131",
		"offer": {
			"offer_id": "a4268fe6-5d8d-4240-a7c5-1cd7c6746597",
			"name": "Allegro",
			"image": "https://cdn.giftmio.com/offer/a5e7294bc4e2472bfc21e38c3e75afd1.gif",
			"link": "https://giftmio.com/offer/allegro/",
			"traffic_url": "https://tatrck.com/redir/clickGate.php?u=u68EH62H&p=DA76emCJ4o&m=30&url=https%3A%2F%2Fallegro.pl%2Foferta%2Fkfd-premium-creatine-500-g-kreatyna-monohydrat-zielone-jablko-15745249131&s=790402d2-0406-45fb-88d0-d06a8eb520d8",
			"cashback_size": "1.45%",
			"countries": [
				"PL"
			],
			"domains": [
				"allegro.pl"
			]
		}
	}
]
3. To find out if a user is registered by uuid in giftmio - GET
https://giftmio.com/api/extension/v1/<uuid>/profile/:

curl --request GET \
  --url https://giftmio.com/api/extension/v1/790402d2-0406-45fb-88d0-d06a8eb520d8/profile/ \
  --header 'authorization: Token <token>'
respond:

{
	"is_registered": true,
	"public_uuids": [
		"790402d2-0406-45fb-88d0-d06a8eb520d8"
	]
}
public_uuids - A list of all uuid bound to the account.
To properly attribute users from the extension, you need to pass their uuid into the registration/login link in the giftmio service:

https://giftmio.com/sso/login/?ex_uuid=<uuid>
https://giftmio.com/sso/register/?ex_uuid=<uuid>
For example, for a user with uuid="790402d2-0406-45fb-88d0-d06a8eb520d8" links will be:

https://giftmio.com/sso/login/?ex_uuid=790402d2-0406-45fb-88d0-d06a8eb520d8
https://giftmio.com/sso/register/?ex_uuid=790402d2-0406-45fb-88d0-d06a8eb520d8
One user in giftmio can have several uuids linked to him, for example he has an extension installed on several devices and different uuids are generated there. Now it is not necessary to register in giftmio, even if the user is not registered, we give already affiliate links for the uuid of his extension and the user can make orders and they will go to this uuid in giftmio.

After registration or login to an existing account we bind the uuid of the extension to our account and all orders that have been or will be made via affiliate links from the uuid of the extension will go to the bound account.

Before giving a link to login/registration you need to request any of our api - at this point the uuid is linked to the webmaster and then we can determine that it was this webmaster who brought this user to giftmio.

Rewards webmaster will receive only for new user registrations in giftmio their actions.

To get access to the api we need the webmaster login in admitad, his site and should be connected to the campaign Giftmio [Lifetime] Many GEOs.
Privacy Policy