# Feed Requests

# Requesting a Feed

To retreive a feed of bids, make a GET request with the following schema:

http://[subdomain].feed.dntx.com/[feedType]?u=[userName]&a=[apiKey]&kw=[keyword]&ip=[ip]&ua=[userAgent]&d=[domain]&cat=[category]&format=[format]&results=[results]&cpc=[cpc]&test=[test]&subid=[subid]&xff=[xff]&remip=[remip]&vid=[viewid]

# Parameters

Field Query Parameter Mandatory Values Description
subdomain Specific subdomain of your publisher account
feedType ppr, ndr, pop, eml Type of feed
userName u Username / email of your publisher account
apiKey a API Key of your publisher account
keyword kw One or more Strings - seperated by , Keyword(s) you are requesting ads for
ip ip Valid IP IP of the visitor, has to match in the click
userAgent ua User Agent of the visitor, has to match in the click
domain d Domain without hostname, SHA hash if feedType is ndr Domain of the visitor is originating
category cat adult, non-adult Traffic category
format format json, xml Response format; Default: xml
cpc cpc Decimal Minimum CPC required for you to accept our bid on the visitor
subid subid max. 30 Character String, consisting off: a-z,0-9,- and _ Custom-Id for your reports and stats. Retreiving stats based on subid requires special permissions!
xff xff One or more IP addresses - seperated by , X-Forwarded-For header replacement
remip remip An IP address. If xff is not omitted, this is mandatory Remote IP address of the client
viewid vid A maximum 32 character String A view id you may send to recognize the request in further reports

# Response

The response will be in the format you specified - or xml, if omitted on request.

On success the PPR/POP/EML feed will always return one result containing the cpc for a successful redirect and the target url. (As long as your account is in the testing-phase the target url contains “id=testing-“)

Field Values Description
status Number - HTTP-Code Success: 200; Failure: any other value
bid Bid One or more bids if request was successful
message String Error message if request was not successful

# Bid

Field Values Description
cpc Float Cost per click or the bid
url String Target URL

# Example

# Request

http://pub123.feed.dntx.com/ppr?u=testuser@tonic.com&a=6df5ab77b45572126584f6c890fbc57a&kw=prepaid+3g&ip=123.456.789.123&ua=Mozilla/5.0%20(Windows%20NT%205.1;%20rv:10.0)%20Gecko/20100101%20Firefox/10.0&d=3g.eu&cat=non-adult&format=json&results=1&cpc=0.002&subid=abcdefg&xff=192.168.0.1&remip=171.15.245.1&vid=8c471df579904901c1110d0987127a2d

# Response

# XML

Success:

<dntx>
	<status>200</status>
	<bid>
		<cpc>0.0511</cpc>
		<url> <![CDATA[https://p1.dntrck.com/tr?id=315c6ecab795ee92b844c658155a562ec4709ebb.r&tk=eyj0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJwdWIIOiJkbnR4QGFkcGlsZS5uZXQiLCJ0cyI5IjExMTAxMjQzIiwiZCI6InlvdXR1Yi5kZSJ9.Hy4JtCifb2sDjWEuWQ_JOtF9yTaytjGDqUhd3eNt01a]]> </url>
	</bid>
</dntx>

Error:

<dntx>
	<status>404</status>
	<message>no bids</message>
</dntx>

# JSON

Success:

{
	"status": 200,
	"bid":
	{
		"cpc": 0.0511,
		"url": "https://p1.dntrck.com/tr?id=315c6ecab795ee92b844c658155a562ec4709ebb.r&tk=eyj0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJwdWIIOiJkbnR4QGFkcGlsZS5uZXQiLCJ0cyI5IjExMTAxMjQzIiwiZCI6InlvdXR1Yi5kZSJ9.Hy4JtCifb2sDjWEuWQ_JOtF9yTaytjGDqUhd3eNt01a"
	}
}

Error:

{
	"status": 404,
	"message": "no bids"
}
Last Updated: 7/21/2020, 8:06:44 AM