Offer18 Knowledge Base
  • Welcome!
  • Network
    • Offers
      • Create New Offer
      • Advertiser URL Builder
      • Tracking URL Macros
      • Offer - General
      • Offer - Targeting
      • Offer - Targeting Rules
      • Offer - Creatives
      • Offer - Assign Affiliates
      • Offer - Capping Rules
      • Offer - Events
      • Offer - Payout Rules
      • Offer - Anti-Fraud
      • Offer - Fallback / JS Integration
      • Create CPS offer
      • Revenue Share Offer
      • Smart Offer
      • Deep Link
      • Pre-landing Page
      • Offer Categories
      • Coupons
      • Suppression List
      • Retargeting Tag
    • Affiliates
      • Create Affiliate
      • Affiliate Profile
      • Affiliate Employee
      • Manage Affiliates
      • Manage Offers
      • Generate Tracking URL
      • Affiliate Global Postback
      • Affiliate Postback Test
      • API Access Manage
      • Log in Affiliate Account
      • Reset Password
      • Affiliate Referrals
    • Advertisers
      • Create Advertiser
      • Advertiser Profile
      • Advertiser's Offers
      • Advertiser Test Link
      • Login as Advertiser
      • Password Reset
    • Postback Integration
    • Integration
      • Shopify
      • Cookieless integration with Shopify
      • WooCommerce
      • Cookieless integration with WooCommerce
    • Mobile Attribution Integration
      • AppsFlyer
        • Global Attribution URL
        • AppsFlyer Normal Postback
        • Advanced Privacy Postback
        • AppsFlyer - Click Signing
      • Adjust
      • Branch
      • Singular
      • Kochava
    • Reports
      • Reports
      • Reports - KPI
      • Reports - Templates
      • Conversion Logs
      • Affiliate Postback Logs
      • Advertiser Postback Logs
      • Capping Logs
    • Account Configuration
      • General Settings
      • Tracking Settings
      • Custom Appearance
      • SMTP Settings
      • Affiliate Settings
      • Advertiser Settings
    • Employees
      • Create Employee Account
      • Custom - Permissions
      • Clone Permissions
      • Additional Access
    • Tools
      • Mailer
      • Import Data
        • Import Affiliates
        • Import Affiliate Postback
        • Import Advertisers
        • Import Offers
        • Import Conversions
      • Offer Sync
        • Offer Sync Guide
        • Sync Logs
      • Product Feed
      • Automation
      • Link Tester
      • Fraud Detection
        • Fraud Fender
        • Conversion Risk Monitor
        • 3rd Party Integrations
    • Network API
      • Offers API
      • Offer Create API
      • Conversion API
      • Reports API
      • Login API
      • Affiliate & Advertiser Create API
      • Affiliate & Advertiser Password Reset
    • FAQ's
      • How to define event price in Payout Rule?
      • How to define affiliate specific payout in Payout Rules?
      • How to view Click logs?
      • What are different status in Advertiser Postback logs?
      • Why Domain have been flagged for SPAM?
      • What are different Affiliate Tracking URL Parameters?
    • SDK
      • Web SDK
      • Cookieless Tracking
      • Android SDK
      • Node SDK
      • Track User Journey
    • Probabilistic Attribution
  • Universal
    • IPs Whitelist
    • Common Values
  • Affiliate
    • Affiliate API's
      • Offers API
      • Request Offer API
      • Reports API
      • Coupon API
      • OTP API
      • SDK - Affiliate Offer Table
    • Integration
      • Google Ads Integration
      • Google Ads Integration - Web SDK
      • Offer18 - Zapier - Google Ads
      • Facebook Ads Integration
      • Facebook Conversion API
      • TikTok Event API
      • Snapchat Conversion API
    • Deep Link
    • Referral Program
  • iGaming
    • iGaming - Create Offer
    • iGaming - Events
    • iGaming - Reports
    • iGaming - Postback
    • iGaming - API
      • User API
      • Activity API
    • iGaming - SDK
      • WebSDK
Powered by GitBook
On this page
  • Common Parameters
  • Filters
  • Example API Request
  • API Response

Was this helpful?

  1. Affiliate
  2. Affiliate API's

Offers API

PreviousAffiliate API'sNextRequest Offer API

Last updated 2 months ago

Was this helpful?

GET https://api.offer18.com/api/af/offers

Common Parameters

Parameter

Type

Description

key

String

API Key

aid

Integer

Affiliate Id

mid

Integer

Your Advertiser MID


Filters

Query

Type

Description

offer_id

Integer

OfferID (&offer_id=000,001,002)

page

Integer

Page Number (&page=1)

category

String

Offer's category (&category=000,000,000)

model

String

Offer Model (&model=CPA,CPC)

country

String

Country Based Offers (&country=US, IN, AU)

offer_status

Integer

Allowed values: 1: Active offers (&offer_status=1)

authorized

Integer

Allowed values: 1: Assigned Offers (&authorized=1)

https://api.offer18.com/api/af/offers?key=000000000&aid=0000&mid=0000&offer_id=0000000&model=000


Example API Request


API Response

{
  "response": "200",
  "data": {
    "00011": {
      "offerid": "00011",
      "name": "XXXXX",
      "logo": "https://example.com/sample.jpeg/",
      "status": "active",
      "category": "download campaigns, gaming, subscription offers, Ecommerece Campaign",
      "currency": "USD",
      "price": 100,
      "model": "CPA",
      "date_start": "2019-05-09 02:19:00",
      "date_end": "2021-08-31 02:19:00",
      "preview_url": "https://www.example.com/?offerid=00011",
      "offer_terms": "These are the offer terms",
      "offer_kpi": "",
      "country_allow": "IN,US",
      "country_block": "GB",
      "city_allow": "",
      "city_block": "",
      "os_allow": "",
      "os_block": "",
      "device_allow": "",
      "device_block": "",
      "isp_allow": "",
      "isp_block": "",
      "browser_allow": "",
      "browser_block": "",
      "capping": [
        {
          "rule_type": "shared_capping",
          "event": "",
          "type": "gross_conversions",
          "period": "daily",
          "value": 100,
          "timezone": null,
          "rule_id": "00000"
        },
        {
          "rule_type": "affiliate_capping",
          "event": "",
          "type": "approved_conversions",
          "period": "daily",
          "value": 100,
          "timezone": null,
          "rule_id": "00000"
        }
      ],
      "events": [
        {
          "event_name": "registration",
          "event_token": "registration"
        }
      ],
      "payout": [
        {
          "payout": "515.0000",
          "currency": "USD",
          "model": "CPA",
          "condition": [
            [
              {
                "field": "event",
                "operator_type": "is_equal",
                "value": "reagistration"
              },
              {
                "field": "country",
                "operator_type": "is_equal",
                "value": "US"
              },
              {
                "field": "device_type",
                "operator_type": "is_equal",
                "value": "smartphone"
              },
              {
                "field": "browser",
                "operator_type": "is_equal",
                "value": "ch"
              },
              {
                "field": "os",
                "operator_type": "is_equal",
                "value": "android"
              }
            ]
          ],
          "rule_id": "00000"
        }
      ],
      "suppression_list": [
        {
          "name": "Sample Suppression list",
          "file_url": "https:\/\/storage.googleapis.com\/offer18-user-data\/suppression\/0000\/3dd0e00000f9202c8602b84feaf7_file.zip?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=service-account%40offer18.iam.gserviceaccount.com%2F20250324%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20250324T122057Z&X-Goog-Expires=172800&X-Goog-SignedHeaders=host&X-Goog-Signature=5ce353be3a209f62098d934b32b40d3af66b52a203ca821158c642a7c80c939af5bbad6435c2ce441b24e52df7f7bed4d4c54af8c4a8b54510c1dd7a55922ea49e52e1d1d4b6060000000653252a5d09c272f4748acf990c6eee95e166a87515fe984224fd587cf2c33d",
          "unsubscribe_url": "https:\/\/example.com",
          "subject_lines": "sample subject lines",
          "from_lines": "sample from lines"
        }
      ],
      "impression_url": "https://mynet.o18.click/i?o=00011&m=000&a=00000",
      "click_url": "https://mynet.o18.click/c?o=00011&m=000&a=00000",
      "authorized": "true",
      "creatives": [
        {
          "type": "image",
          "url": "https://example.com/creative_00001.png"
        },
        {
          "type": "image",
          "url": "https://example.com/creative_00002.png"
        },
        {
          "type": "html",
          "url": "https:example.com/creative00002.zip"
        }
      ],
      "targeting": [
        {
          "action_on_clicks": "allow",
          "condition": [
            [
              {
                "field": "country",
                "operator_type": "is_equal",
                "value": "IN,US"
              },
              {
                "field": "device_type",
                "operator_type": "not_equal",
                "value": "smartphone"
              }
            ]
          ],
          "rule_id": "101"
        },
        {
          "action_on_clicks": "reject",
          "condition": [
            [
              {
                "field": "os",
                "operator_type": "not_equal",
                "value": "android"
              }
            ]
          ],
          "rule_id": "102"
        },
        {
          "action_on_impressions": "allow",
          "condition": [
            [
              {
                "field": "country",
                "operator_type": "is_equal",
                "value": "IN,US"
              },
              {
                "field": "os",
                "operator_type": "is_equal",
                "value": "windows"
              }
            ]
          ],
          "rule_id": "103"
        }
      ]
    }
  }
}
  1. Shared Capping - A single capping rule shared by multiple Affiliates.

  2. The Suppression File URL will be valid for only 2 hours. We recommend downloading and using the file promptly to ensure uninterrupted access and functionality.

Apply Offer

Query

Type

Description

offer_access

Integer

Allowed values 1: Approve Public Offers (&offer_access=1)

https://api.offer18.com/api/af/offers?key=000000000&aid=0000&mid=0000&offer_access=1

🔗
Click to Test Offers API
🔗
🔗
View Models
View Countries