Binom API Guide: Automating Your Affiliate Campaigns in 2026

Binom API lets affiliates automate clicks, campaigns, offers, and reporting via simple HTTP requests with JSON responses, using an API key passed in the api-key header for v2 trackers. 

Developers can auto-pause poor zones, bulk edit campaigns, fetch stats, and build custom dashboards by combining the Click API and the main REST API endpoints.

If you run paid traffic at scale, automation is no longer optional. Binom v2 ships a documented API that turns your tracker into a programmable engine for affiliate campaign automation.

Why Binom's API Matters for Paid Media Buyers

Binom is a self-hosted ad tracker built for speed, with server-side click tracking and rich reporting. Its API exposes almost every action you can do in UI form. That means scripts can talk directly to your tracker.

Key gains include:

For media buyers, faster decisions equal higher ROI. Pulling stats every minute beats waiting on dashboards. Programmatic campaign control also kills repetitive clicks across rotations, offers, and zones.

Getting Your API Key and First Request

Open Settings, then User, and copy your personal API key. A super-admin key unlocks full tracker access, so guard it like a payout postback. Tracker v2 expects keys in an api-key HTTP header rather than a GET parameter.

Visit https://your-tracker.com/api/doc to load Binom's interactive Swagger reference. Click Authorize, paste your key, then hit Try it out on any endpoint to fire test requests. Postman works too, and a public Postman collection is available for quick prototyping.

A starter cURL call to fetch a campaign link looks like:

curl -H "api-key: XXXXX" https://tracker.com/api/v2/campaign/{id}

Campaign Management Through API Calls

Binom's main API handles offers, landers, traffic sources, campaigns, and costs over HTTP GET or POST. Every create or delete request hits index.php with an action parameter and your API key. JSON returns make parsing trivial in Python, Node, or Bash.

Common automated actions:

Action	Endpoint Type	Use Case
Create offer	POST /api/offer	Sync new payouts from network
Update cost	GET save_update_costs	Pull spend from traffic sources
Edit campaign	POST /api/campaign	Bulk rotation swaps
Delete lander	POST action=delete	Retire dead creatives

A bulk campaign editing script can loop through 200 campaigns and swap an offer rotation in seconds. That same job by hand eats an afternoon.

Reporting Queries and Stat Pulls

Reporting is where Binom's API shines for data nerds. Multilevel reports group by ISP, IP range, OS, browser, and any custom token. Hit the stats endpoint with a date range, grouping, and campaign filter to receive structured JSON.

Smart automated reporting workflows pull data on a cron schedule. A 15-minute cron can:

Mariia Chernysh's open-source Bash scripts on GitHub show how to grab JSON or CSV exports from Binom for downstream BI. Plug those into Looker Studio or Metabase for custom affiliate dashboards without paid SaaS.

Affiliate Network Integration Patterns

Binom ships preloaded templates for hundreds of networks, so postback setup is one click for popular CPA brands. For API-level sync, most networks expose offer feeds you can poll, then post into Binom as new offers.

A typical affiliate network integration workflow:

For Alfaleads-style networks, append &sub1={clickid} to the offer URL and accept conversions back through cnv_id={sub1}. ExoClick, PropellerAds, and RichAds all follow the same postback shape.

Building Custom Affiliate Dashboards

Native Binom UI is fast, yet most affiliates want a single pane across multiple trackers and networks. The API answers that need.

Stack ideas:

Add columns for traffic source spend, network revenue, and tracker clicks. That gives a true profit reconciliation dashboard instead of guessing across tabs.

Bulk Operations and Time-Saving Scripts

When you operate 50+ campaigns, manual edits become a bottleneck. Binom API supports batch loops over creates, edits, and archives.

Power moves:

The afflift community shared a Binom v2 API guide in 2024 covering exactly these patterns with sample payloads. Combine that with the official docs for a fast onramp.

Real-World Automation Stack Example

Here's a sample weekly stack that pays for itself fast:

Day	Automation	Tool	API Endpoint
Mon	Clone winners to new GEOs	Python	/api/campaign
Tue	Pull source spend	Bash cron	save_update_costs
Wed	Auto-blacklist bad zones	Node	stats + source API
Thu	Sync new offers from network	Python	/api/offer
Fri	Push KPIs to Slack	Webhook	stats endpoint
Sat	Archive dead campaigns	Bash	action=delete
Sun	Backup tracker data	rsync	full DB dump

Each script is under 100 lines once you copy patterns from the Postman collection. Time saved per week often exceeds 15 hours for a solo affiliate.

Common Endpoints Cheat Sheet

Bookmark these for quick reference:

Always confirm the path on your own /api/doc page since self-hosted versions vary slightly.

Final Notes for Technical Affiliates

Binom's API turns repetitive ops into background jobs, freeing brain time for creative testing and offer negotiation. 

Start small with a stat-pull script, then layer auto-blacklist logic, and finish with a full custom dashboard. Each layer compounds ROI because decisions land faster and waste shrinks.

Pair Binom's API with disciplined logging, version-controlled scripts, and clean postback hygiene, and your media buying turns into a data-driven operation worthy of any performance marketing engineer title.