Advertiser API IN Guide

HugOffers enables automated offer integration via API, where API-IN is designed for advertiser API connections. The system provides 500+ prebuilt API templates for immediate use.

To integrate with an advertiser's API, you need:

  • API documentation

  • Complete API URL

  • Parameter specifications

Adding an API Integration

For API-supported advertisers:

  1. Create an advertiser account.

  2. Navigate to Integration > API-IN Integration.

  3. Click Add to create a new integration.

General Settings

  • API Name: Search for the advertiser/platform name. If unavailable, contact HugOffers support to add a template.

  • Advertiser: Select the advertiser (must be pre-added).

  • API Status: Default is Active.

  • Default Payout(%): Base payout percentage for all offers under this API (applies when offer authorization mode is inherit).

  • Default Daily Cap: Expected daily conversions. -1 means no limit.

Daily Cap Options

a. Use <Api Daily Cap>, if not exist, use <Default Daily Cap> b. Ignore <Api Daily Cap> and use <Default Daily Cap> c. If <Api Daily Cap> equals 0 or not exist, use <Default Daily Cap>

  • Goal Name: Select type (CPI/CPA/CPS/CPR/CPE).

  • Insert Limit: Maximum number of offers to pull via API.

Generate URL

HugOffers auto-generates a URL Template based on the selected API. Fill in parameters (refer to the advertiser's API docs) to generate Result URLs.

Note:

  • Use &page={page[1-10]} if the API limits results per page but lacks pagination parameters.

  • {page[1-10] fetches pages 1-10 (links are system-only and not browser-testable).

Permissions

Configure default authorized affiliates, caps, and payout rules. Offers pulled via this API will auto-authorize these affiliates.

  • Default Cap Percent: Highest priority. Affiliate cap = Default Cap Percent × Default Daily Cap ①. If the advertiser's cap is 0, affiliate cap = Default Daily Cap ②.

Filters

Add filters to screen offers by:

  • Country

  • Platform

  • Incentive type

  • App category

  • Payout (open intervals, non-inclusive).

Click Submit to save.

View & Manage Integrations

  • Counts: Number of offers pulled in the last API fetch.

  • Last Execute Date: Timestamp of the last API pull.

  • Search: Filter by API name, advertiser, affiliate, or status.

Operate Options

  • Edit: Modify API settings.

  • Inactive/Active: Toggle API status.

  • Delete: Remove the API integration.

Important: Clicking "Account Block" on the Advertiser interface sets the API status to Inactive.

PreviousAdd New AdvertiserNextOffer Setup Guide

Last updated

Was this helpful?