{"_id":"564dcfb4d3320b0d0028ca11","category":{"_id":"564dcf87d3320b0d0028ca10","version":"564621e10c30fb2100ba3817","__v":26,"pages":["564dcfb4d3320b0d0028ca11","564dd25da8671617004e7b71","564dd3a7e39c4435005a1f33","564ddbcbd3320b0d0028ca25","564ddcb2a8671617004e7b8e","564ddfffa8671617004e7b94","564de165a8671617004e7b97","564de17d9176e9170068007b","564de194e39c4435005a1f56","564de3d99176e9170068007e","564de439fe07a81700b5c3af","564ef3911e9a082b00344ea1","564f03dfedbade0d000efa57","564f0978234efc0d006e186e","564f0d9aaf8ae235002db90e","564f133e4f000617007bd68e","564f14d829338a1700beefcd","564f15619eb2701700532470","564f2fec6b10960d00865761","564f302b6b10960d00865764","564f33e219857f2b00387a44","564f35d110b21d3500ad29d3","564f42e41af2c835004bfbe9","564f456ab85ee335004cbdb3","5652e161b83d8e0d00d24b6b","56859949cfc7cf0d001cb3f5"],"project":"564621e00c30fb2100ba3814","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-11-19T13:32:55.176Z","from_sync":false,"order":6,"slug":"api-overview","title":"Ad Request API"},"version":{"_id":"564621e10c30fb2100ba3817","__v":15,"project":"564621e00c30fb2100ba3814","createdAt":"2015-11-13T17:46:09.275Z","releaseDate":"2015-11-13T17:46:09.275Z","categories":["564621e10c30fb2100ba3818","564624cf0c30fb2100ba3822","564628d69f3f550d00fa3db6","564dafeeda00e82b00ed601d","564daff8fc36dc3700882b95","564db0ccda00e82b00ed601f","564dcf87d3320b0d0028ca10","5661a6e436398e0d00f79566","568585153703ed1700e420b0","56858767d96a760d00545da6","56858d693703ed1700e420b2","56858d8d22c41b0d00e4666c","56859e9c009a8d0d00797130","5685a6453703ed1700e420d3","5a8bf8dbe86f530012159b73"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"__v":17,"project":"564621e00c30fb2100ba3814","parentDoc":null,"user":"56499dade2efd717002afc83","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-11-19T13:33:40.173Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":true,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"First Steps\"\n}\n[/block]\nTo start requesting live ads from the MobFox Network using our API you'll need to:\n  * [Sign Up for a MobFox Publisher Account](http://www.mobfox.com/signup)\n  * Add your Inventory by logging in and navigating to [Add Site/App](https://account.mobfox.com/www/cp/add_publication.php)\n  * You will now be presented your unique MobFox **Inventory Hash** (e.g. 633de4b0c14ca52ea2432a3c8a5c4c31) which you need to pass to us when requesting ads using our API or SDKs (**&s=** parameter). If you monetize multiple sites or apps with us, you will need to use a separate Inventory Hash for each and every publication.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"API Overview\"\n}\n[/block]\nMobFox APIs is designed to be a flexible way to request ads from any device. The API accepts simple GET requests, with optional and required parameters in the query string portion of the URL. The parameters must be encoded as name/value pairs using the standard HTTP URL-encoding principles.\n\nTo request ads from the MobFox network, you need to issue a HTTP GET request to the following URL.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl \\\"http://my.mobfox.com/request.php?rt=api&\\\"\",\n      \"language\": \"curl\",\n      \"name\": \"Ad Request URL\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"API Docs\"\n}\n[/block]\nThe following link collection is meant to help you jump to the relevant section you are searching for.\n\nIt is recommended to start reading the docs \"top down\" starting with \"Global Ad Request Parameters\".\n\n**Introduction**\n[Global Ad Request Parameters](doc:global-request-parameters)\n[Special Ad Request Parameters](doc:special-ad-request-parameters)\n[Inventory Hashes for Testing](doc:inventory-hashes-for-testing)\n\n**Request Ads**\n[Banner Ads](doc:banners-1)\n[Request  Regular Banners](doc:banners)\n[Request Interstitial Banners](doc:request-interstitial-banners)\n[Request MRAID Banners](doc:request-mraid-banners)\n[Request Video Ads](doc:request-videos)\n[Request Native Ads](doc:request-native-ads-iab)\n[Response Format](doc:response-format) \n[Response Parameters](doc:response-parameters) \n\n**How To's**\n[Passing HTTP Parameters](doc:passing-http-parameters) \n[User Agent](doc:user-agent) \n[IP Address](doc:ip-address) \n[Secure Ads](doc:secure-ads) \n[Common Publisher Issues](doc:common-publisher-issues-supply-side-issues)","excerpt":"You want ads from MobFox!","slug":"ad-request-api","type":"basic","title":"Ad Request API"}

Ad Request API

You want ads from MobFox!

[block:api-header] { "type": "basic", "title": "First Steps" } [/block] To start requesting live ads from the MobFox Network using our API you'll need to: * [Sign Up for a MobFox Publisher Account](http://www.mobfox.com/signup) * Add your Inventory by logging in and navigating to [Add Site/App](https://account.mobfox.com/www/cp/add_publication.php) * You will now be presented your unique MobFox **Inventory Hash** (e.g. 633de4b0c14ca52ea2432a3c8a5c4c31) which you need to pass to us when requesting ads using our API or SDKs (**&s=** parameter). If you monetize multiple sites or apps with us, you will need to use a separate Inventory Hash for each and every publication. [block:api-header] { "type": "basic", "title": "API Overview" } [/block] MobFox APIs is designed to be a flexible way to request ads from any device. The API accepts simple GET requests, with optional and required parameters in the query string portion of the URL. The parameters must be encoded as name/value pairs using the standard HTTP URL-encoding principles. To request ads from the MobFox network, you need to issue a HTTP GET request to the following URL. [block:code] { "codes": [ { "code": "curl \"http://my.mobfox.com/request.php?rt=api&\"", "language": "curl", "name": "Ad Request URL" } ] } [/block] [block:api-header] { "type": "basic", "title": "API Docs" } [/block] The following link collection is meant to help you jump to the relevant section you are searching for. It is recommended to start reading the docs "top down" starting with "Global Ad Request Parameters". **Introduction** [Global Ad Request Parameters](doc:global-request-parameters) [Special Ad Request Parameters](doc:special-ad-request-parameters) [Inventory Hashes for Testing](doc:inventory-hashes-for-testing) **Request Ads** [Banner Ads](doc:banners-1) [Request Regular Banners](doc:banners) [Request Interstitial Banners](doc:request-interstitial-banners) [Request MRAID Banners](doc:request-mraid-banners) [Request Video Ads](doc:request-videos) [Request Native Ads](doc:request-native-ads-iab) [Response Format](doc:response-format) [Response Parameters](doc:response-parameters) **How To's** [Passing HTTP Parameters](doc:passing-http-parameters) [User Agent](doc:user-agent) [IP Address](doc:ip-address) [Secure Ads](doc:secure-ads) [Common Publisher Issues](doc:common-publisher-issues-supply-side-issues)