Receiving Click and Cost Data via HTTP Requests

This page outlines how vendors can receive Snagajob click and cost data for Apply Now button click events via an API endpoint.

Overview

Partners can include a <TrackingUrl> element in their XML feed (must be HTTPS) for each posting they would like to receive event details for. When a Worker clicks the ‘Apply Now’ button on snagajob.com, Snagajob will perform an HTTP GET request to the URL appending these query string parameters.

  • timestamp

  • eventId

  • clickCost

  • ipAddress

Query String Parameter Descriptions

Name
Description
Example

timestamp

The click event time represented as an Epoch Unix Timestamp. All clicks are recorded in Eastern Time.

10111000

eventId

The unique id for the click event.

78dbe8d7-bc12-42ba-97d8-6f7236bbb009

clickCost

The cost per click that the posting was bidding at the time of the event.

22

ipAddress

The IP Address of the user who generated the click event

1.1.1.1.1

Example Tracking URL

<TrackingUrl>https://myapplicantapi.com/where-clicks-should-go</TrackingUrl>

Example XML Containing the <TrackingUrl>

<?xml version='1.0' encoding='UTF-8'?>
<Postings>
    <Item>
        </Brand>
        </Job_Title>
        </Employment_Type>
        </Wage>
        </Location_Name>
        </Address_Line_1>
        </City>
        </State>
        </Zip>
        </Rate>
        </Job_Description>
        </Primary_Industry>
        </URL>
        </External_Posting_ID>
        </Location_Number>
        </PostUrl>
        </ScreeningQuestionsUrl>
        <TrackingUrl><![CDATA[https://myapplicantapi.com/where-clicks-should-go]]></TrackingUrl>
    </Item>
</Postings>

Example Request

Snagajob's Sample Request for Sending Click Data

GET https://myapplicantapi.com/where-clicks-should-go

Query Parameters

Name
Type
Description

timestamp*

String

The click event time represented as an Epoch Unix Timestamp. All clicks are recorded in Eastern Time.

eventId*

String

The unique id for the click event.

clickCost*

String

The cost per click that the posting was bidding at the time of the event.

ipAddress*

String

The IP Address of the user who generated the click event

Example Url: https://myapplicantapi.com/where-clicks-should-go?eventId=78dbe8d7-bc12-42ba-97d8-6f7236bbb009&timestamp=10111000&clickCost=22&ipAddress=1.1.1.1.1

Last updated

Was this helpful?