{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/Public","auth":"never","results":{"codes":[{"name":"","code":"{\n  \"Public\":\t[\n    {\n      \"OfferID\":162836,\n      \"OfferType\":\"free\",\n      \"Title\":\"VIP Voice\",\n      \"Description\":\"Take Surveys. Get Rewarded!\",\n      \"Steps\":\"Credits awarded upon completing full registration and completing one or more surveys.\",\n      \"Logo\":\"http:\\/\\/assets.superrewards-offers.com\\/assets\\/54cc1bb8efa6c.jpg\",\n      \"EarnPoints\":75,\n      \"EarnText\":\"75 credits\",\n      \"PointsLabel\":\"credits\",\n      \"ClickURL\":\"\\/super\\/go?h=rylsgzpgamykmmhjylbjzgqpnloxbnorpxpjdhacmfkohpjkcoismzmsjpjkplqrnjpgauyzxyhxd.543241745786&r=&cs=76&sl=4\",\n      \"CommitmentLevel\":1,\n      \"CommitmentLevelText\":\"No purchase required to receive 75 credits\",\n      \"CommitmentShortText\":\"Free\",\n      \"CommitmentEnglish\":\"free\",\n      \"CompletedCount\":351,\n      \"TimeToCompletion\":\"Credits within <b>15 minutes<\\/b>\",\n    }\n  ],\n  \"ErrorCode\":\"\",\n  \"ErrorMessage\":\"\",\n  \"HTTPResponseCode\":200\n}","language":"json","status":200},{"name":"","code":"{\n    \"Offers\": [],\n    \"ErrorCode\": \"400v0\",\n    \"ErrorMessage\": \"INVALID REQUEST: No arguments passed\",\n    \"HTTPResponseCode\": 400\n}","language":"json","status":400}]},"settings":"","examples":{"codes":[{"language":"text","code":"","name":""}]},"method":"get","params":[{"name":"h","type":"string","default":"icfb","desc":"App hash","required":true,"in":"query","ref":"","_id":"54d309f42ce0e00d00751633"},{"name":"uid","type":"int","default":"12340987","desc":"Unique User ID in your system.","required":true,"in":"query","ref":"","_id":"54d30e03d0b2871900cda6b9"},{"name":"ip","type":"string","default":"","desc":"The user's IP address, so we can determine which offers to fetch based on geographic location","required":true,"in":"query","ref":"","_id":"561458cf79fdd00d0085b1fb"},{"name":"mode","type":"string","default":"all","desc":"What offers to show","required":false,"in":"query","ref":"","_id":"54d309f42ce0e00d00751635"},{"name":"n_offers","type":"int","default":"30","desc":"The number of offers to return (per tab). Defaults to 30.","required":false,"in":"query","ref":"","_id":"54d30e03d0b2871900cda6b8"},{"name":"page","type":"int","default":"0","desc":"When requesting paginated results, set to the page number you are requesting. 0 based. Defaults to 0 if not specified.","required":false,"in":"query","ref":"","_id":"54d309f42ce0e00d00751634"},{"name":"lang","type":"string","default":"en","desc":"The 2 character language code of the user. This is normally detected, but you may pass this value to override the language or if acting as a proxy. See: http://en.wikipedia.org/wiki/IETF_language_tag","required":false,"in":"query","ref":"","_id":"54d30e03d0b2871900cda6b7"},{"name":"age","type":"int","default":"","desc":"Users age in years.","required":false,"in":"query","ref":"","_id":"54d30e03d0b2871900cda6b6"},{"name":"gender","type":"string","default":"","desc":"The users gender (m or f)","required":false,"in":"query","ref":"","_id":"54d30e03d0b2871900cda6b5"},{"name":"tags","type":"string","default":"","desc":"List of comma separated tags to use to use as a filter for offers.","required":false,"in":"query","ref":"","_id":"54d30e03d0b2871900cda6b4"},{"name":"custom_MYVALUE","type":"string","default":"","desc":"Client supplied custom parameters. Specify any parameter you require (starting with \"custom_\"). These custom parameters are passed back to your server postback endpoint upon successfull completion.","required":false,"in":"query","ref":"","_id":"54d30e03d0b2871900cda6b3"},{"name":"from","type":"int","default":"","desc":"Sets the minimum VC points filter (must be used with \"to\" parameter).","required":false,"in":"query","ref":"","_id":"54d30e03d0b2871900cda6b2"},{"name":"to","type":"int","default":"","desc":"Sets the maximum VC points filter (must be used with \"from\" parameter).","required":false,"in":"query","ref":"","_id":"54d30e03d0b2871900cda6b1"}]},"next":{"description":"","pages":[]},"title":"Native Offers API","type":"endpoint","slug":"native-offers-api","excerpt":"","body":"[block:callout]\n{\n  \"type\": \"success\",\n  \"body\": \"This exposes the same API we use to display our offer wall if you [use our iFrame integration](doc:getting-started) so that you can incorporate offers into your own user experience, in the best times and places for your users.\",\n  \"title\": \"Customize Your Experience\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Required Fields\"\n}\n[/block]\n\nWhile it has options that allow a lot of flexibility, you only need two fields:\n* `h`: the app hash for your app, generated by our system and available in your [Dashboard](https://pub.superrewards.com).  For more info see [Foundation: Hashes and Keys](doc:foundation-app-hashes-keys-and-signing).\n* `uid`: a unique ID for the user, either numeric or text. Check out our [Notes on UIDs](doc:notes-on-uids). \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Filtering By Mode\"\n}\n[/block]\nThe `mode` field determines what type of offer you are requesting.  Possible values are:\n* `all`\n* `paid`\n* `free`\n* `survey`\n* `video`\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Using The Results\"\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/224kuMssSh6wzB651gkI_skitch.png\",\n        \"skitch.png\",\n        \"972\",\n        \"331\",\n        \"#ed5aae\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"An Easy Test\",\n  \"body\": \"To try out the live tool below, use these values to get one offer back from the server:\\n* `h`: `icfb` (this is one of our test apps)\\n* `uid`: `9876541` (a fake user ID)\\n* `mode`: `all`\\n* `n_offers`: `1`\"\n}\n[/block]","updates":["561bba43c89cc30d008215e7","561bbb71f619210d00a85c80","563d0ce48894d20d00014f29","57811a019a9ff80e0051bf22","5781286d6f4c1d200064e0c6"],"order":0,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"54d309f42ce0e00d00751632","__v":9,"createdAt":"2015-02-05T06:13:08.980Z","editedParams":true,"parentDoc":null,"category":{"sync":{"isSync":false,"url":""},"pages":["54d309f42ce0e00d00751632","56b36ff3ce8e5a1700f7c3e0"],"title":"API Access","slug":"api-access","order":9999,"from_sync":false,"reference":false,"_id":"54d309955616470d0013cc55","__v":2,"createdAt":"2015-02-05T06:11:33.180Z","project":"542998547a6b69080076806e","version":"542998547a6b690800768071"},"editedParams2":true,"user":"542998207a6b690800768069","version":{"version":"1.0","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["542998547a6b690800768072","5433027990d63b1c0030c0f1","5433028190d63b1c0030c0f2","5433028d9a2b451a00ad4508","5433055790d63b1c0030c10a","5461417d37e5bc200049e1e4","54624066ddd31b0800a58db4","54625de66d1f1010002f3901","54d309955616470d0013cc55"],"_id":"542998547a6b690800768071","__v":9,"createdAt":"2014-09-29T17:35:16.249Z","project":"542998547a6b69080076806e","releaseDate":"2014-09-29T17:35:16.249Z"},"githubsync":"","project":"542998547a6b69080076806e"}

getNative Offers API


Definition

{{ api_url }}{{ page_api_url }}

Parameters

Query Params

h:
required
stringicfb
App hash
uid:
required
integer12340987
Unique User ID in your system.
ip:
required
string
The user's IP address, so we can determine which offers to fetch based on geographic location
mode:
stringall
What offers to show
n_offers:
integer30
The number of offers to return (per tab). Defaults to 30.
page:
integer0
When requesting paginated results, set to the page number you are requesting. 0 based. Defaults to 0 if not specified.
lang:
stringen
The 2 character language code of the user. This is normally detected, but you may pass this value to override the language or if acting as a proxy. See: http://en.wikipedia.org/wiki/IETF_language_tag
age:
integer
Users age in years.
gender:
string
The users gender (m or f)
tags:
string
List of comma separated tags to use to use as a filter for offers.
custom_MYVALUE:
string
Client supplied custom parameters. Specify any parameter you require (starting with "custom_"). These custom parameters are passed back to your server postback endpoint upon successfull completion.
from:
integer
Sets the minimum VC points filter (must be used with "to" parameter).
to:
integer
Sets the maximum VC points filter (must be used with "from" parameter).

Result Format


Documentation

[block:callout] { "type": "success", "body": "This exposes the same API we use to display our offer wall if you [use our iFrame integration](doc:getting-started) so that you can incorporate offers into your own user experience, in the best times and places for your users.", "title": "Customize Your Experience" } [/block] [block:api-header] { "type": "basic", "title": "Required Fields" } [/block] While it has options that allow a lot of flexibility, you only need two fields: * `h`: the app hash for your app, generated by our system and available in your [Dashboard](https://pub.superrewards.com). For more info see [Foundation: Hashes and Keys](doc:foundation-app-hashes-keys-and-signing). * `uid`: a unique ID for the user, either numeric or text. Check out our [Notes on UIDs](doc:notes-on-uids). [block:api-header] { "type": "basic", "title": "Filtering By Mode" } [/block] The `mode` field determines what type of offer you are requesting. Possible values are: * `all` * `paid` * `free` * `survey` * `video` [block:api-header] { "type": "basic", "title": "Using The Results" } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/224kuMssSh6wzB651gkI_skitch.png", "skitch.png", "972", "331", "#ed5aae", "" ] } ] } [/block] [block:callout] { "type": "success", "title": "An Easy Test", "body": "To try out the live tool below, use these values to get one offer back from the server:\n* `h`: `icfb` (this is one of our test apps)\n* `uid`: `9876541` (a fake user ID)\n* `mode`: `all`\n* `n_offers`: `1`" } [/block]

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}