Skip to main content

Advertiser API (Networks)

Set up an API connection with your advertiser to automatically import their offers into Swaarm.

Overview

Advertiser API (Networks) allows you to connect a network or tracker to Swaarm via API so that offers are imported automatically. Once connected, new offers from the advertiser's feed appear in Integration → Offers Approval for review.

💡 Before setting up the network, make sure the advertiser has been created in Swaarm and has approved at least some offers for you - this allows you to verify the connection works correctly in the Preview step.


Where to Find Networks

Go to: Integration → Networks

To add a new network, click + Create. To update an existing one, find it in the list and click Edit.


How to Set Up a Network

Step 1 - Configure API

  • Select the Adapter for the network or tracker you want to integrate

  • Enter the API credentials provided by the advertiser

  • Set the global margin to apply to all offers imported from this network

  • Select the Advertiser in Swaarm that this network should be linked to

ℹ️ Each adapter requires different credentials. For adapter-specific setup instructions, see the Network Configuration articles.


Step 2 - Configure Tracking Link

Map the advertiser's click parameters to the corresponding Swaarm macros. Swaarm pre-fills the most common mapping by default.

ℹ️ Always confirm the required parameters with the advertiser - they may ask you to pass different values than the default suggestion.


Step 3 - Configure Fields

Select which offer fields should be continuously synced from the API or just when added to the feed. Fields not selected will not be updated when the advertiser changes them on their side.


Step 4 - Preview and Enable Syncing

If the API credentials were entered correctly in Step 1, a preview of available offers is displayed. Verify that offers are appearing as expected.

Check the Syncing toggle to start syncing offers from the API.

ℹ️ Once syncing is enabled, imported offers will appear in Integration → Offers Approval. They can be approved manually on Offers Approval page or automatically via Autoapproval Rules.

Did this answer your question?