NAV
terminal

API Key

Earn bounties by displaing banner ads in your web and apps using our Rest API.

You must first register for a free account using the Bounty Mobile app in order to obtain your unique API key. You must then apply for approval using the app - once approved you will then begin earning the offers you serve. You are welcome to integrate with the API before approval is granted but you will not earn from any traffic until then. Approval takes 2-3 working days.

GET /ads

Request all ads

curl --request GET \
  --url https://api.bountymobile.com/ads \
  --header 'API_KEY: XXXXXXXXXXXXXXXXXXXXXXXX'

Response

[
    {
        "adId": 1,
        "categoryName": "Software and Services",
        "merchantId": 9,
        "merchantName": "Viddyoze",
        "affiliateUrl": "http://api.bountymobile.com/PNboaJ",
        "regions": "US,GB",
        "imageUrl": "https://bountymobile.com/selfhosted/image.png",
        "type": "square",
        "logoUrl": ""
    },
    {
        "adId": 2,
        "categoryName": "Computers and Internet",
        "merchantId": 10,
        "merchantName": "NordVPN",
        "affiliateUrl": "https://api.bountymobile.com/4CBsCl",
        "regions": "",
        "imageUrl": "https://bountymobile.com/selfhosted/image.png",
        "type": "horizontal",
        "logoUrl": ""
    }
]

Request all ads by making a GET request to the /ads endpoint using your API_KEY in the header. Display the image imageUrl and send the user to the affiliateUrl on click to earn from the click or sale. The affiliateUrl is unique to you and provides everything we need to make sure you get attributed the correct payment.

Filter for specific merchants

Filter by list of merchants

https://api.bountymobile.com/ads?merchants=22,43,39 // decoded

curl --request GET \
  --url 'https://api.bountymobile.com/ads?merchants=22%2C43%2C39' \
  --header 'API_KEY: XXXXXXXXXXXXXXXXXXXXXXXX'

To promote specific merchants, provide a single merchant ID (found in the app) or a comma seperated list of IDs using the merchants query parameter.

Filter by banner type

Filter by banner type

https://api.bountymobile.com/ads?type=square

curl --request GET \
  --url 'https://api.bountymobile.com/ads?type=square' \
  --header 'API_KEY: XXXXXXXXXXXXXXXXXXXXXXXX'

Filter by both merchant and type

https://api.bountymobile.com/ads?merchants=12&type=square

Return only banners of the type or size you require using the type query parameter.

Types

Rules & Compliance

To ensure you're account remains active and to continue promoting offers with Bounty Mobile you MUST comply with the following rules:

Clearly indicate each advert

Make it clear to the user that you are displaying an ad by displaying 'Advertisement', 'Ad' or 'Sponsored' clearly to the user wherever you place an ad. Never send a user to an advertiser link without their clear intention to visit the ad (e.g. only redirect the user on a banner click, and don't do anything misleading or that may trick the user to click)

Display in valid country only

Where an ad specifies regions (e.g. GB, DE) you must only show the ad in that region. Where no regions are specified, the ad can be used in all regions. Only clicks from valid regions are counted.

Fake clicks

Do not click your own ads or attempt to game the system in any way. This is regularly monitored using machine learning and will be banned upon detection.

How to earn more

Improving the quality of your traffic to your ads will increase your payout rates which can lead to significant increases in profits. Example of how to improve your payout rates:

Introduce Offer

First introducing the user to the offer and then showing a banner or hyperlink (Clearly indicated as a sponsor) for them to purchase the product

Target Market

Focus on a smaller number (or a single) merchant that matches your target market or niche

Display Positioning

Place the ad in the perfect position on your page or app (e.g. between list items in product listings)

Positive Journeys

Never present as a popup that might frustrate your user, only show ads where they will be well received and the user is not forced to engage if they choose not to

Delete Account

Delete your account at any time by emailing hello@bountymobile.com with the subject 'Remove Account' and your account will be removed within 30 days including any data associated with your account e.g. email address, usage stats.

terminal