There are two endpoints to interact with for push publishers. The first “Request Push Content” endpoint will return content you are able to push out - everything you need from image, headline, and url will be returned to you.
The second endpoint “Track Events” is what you will POST to when displaying a push to the user. It is required that you track impressions - the impression hash that is given in the content call is what is passed to the track call.
Request Push Content
Endpoint:
GET push.revcontent.com/push/content/
Request Parameters:
api_key
widget_id
country_code - EX: us, ca, in, br
device - EX: desktop / mobile / tablet
format - (Optional) Ex. json / xml
Request Example:
https://push.revcontent.com/push/content/?api_key=yourapikey&widget_id=12345&device=desktop&country_code=us
Response Example:
{"content":
[{"headline":"The 12 Best Headlines Of All Time",
"url":"//trends.revcontent.com/click.php?d=CaT%2B",
"image":"//img.revcontent.com/175.jpeg&static=true&pos=face&h=315&w=420&static=true&fmt=jpeg",
"brand":"Big Brand",
"type":"sponsored",
"uid":"sponsored_3520",
"content_type":"article",
"favicon_url":"",
"description":"",
"target_url":"http://www.example.com/",
"is_local_domain_content":false,
"ext_domain_logo":"",
"impression":"gQNRktEEQfr9yKJh2"}]}
Track Events
Endpoint:
GET/POST https://push.revcontent.com/push/track/
Request Parameters:
d
Request Example:
https://push.revcontent.com/push/track/?d=gQNRktEEQfr9yKJh2
Response Example:
204 No Content
NOTE: image dimensions can be modified by string replacing on the h and w parameters of the image in the response