IVANHOE.io API for cloaked links

August 25, 2016 | Bart Houtman
A lot of affiliates are cloaking their links to make them Search Engine Friendly, show a waiting screen or because it just looks nicer. So for example http://ds1.nl/c/?wi=187181&si=982&li=1177805&ws= will become http://affiliatewebsite.com/go/advertiser. IVANHOE.io can work with cloaked links if the affiliate is able to insert the IVANHOE sub id into the affiliate url from a cloaked link. 

How to get IVANHOE subids in cloaked links?

You just need to create and pass a user session using the IVANHOE.io API. Just follow the instructions below and you'll get started in no time!

To start using it you need a Developer ID and a password.  You can get your Developer ID and password in your IVANHOE.io dashboard (Account > API Access). Currently the IVANHOE.io API has only one resource to track user session. It returns a sub id that should be passed to affiliate networks.

Allowed methods: POST

Required parameters: 
  • hostname. The hostname of your website with a protocol
  • google_client_id. A google client ID from cookies. Usually it looks like this: GA1.2.111111111.1111111111 and stored on cookies with the key _ga.
The Ivanhoe API uses HTTP methods and a RESTful endpoint structure. You can use Basic auth to get access rights.

An example request:


POST /api/v1/session HTTP/1.1
Host: ivanhoe.io
Authorization: Basic dGVzdDpzZWNyZXQ=
Cache-Control: no-cache
Content-Type: application/x-www-form-urlencoded

Body: hostname=http://test.com&google_client_id=GA1.2.111111111.1111111111