🌐 Impact.com Affiliate Network — Campaigns, Catalogs, Reports API (BYOC)

🔗 View on Apify Store | 🇺🇸 English | 🇧🇷 Português

Query the Impact.com Publisher API (api.impact.com) for campaigns, product catalogs, ads, promo codes, transactions, and 60+ canned reports. BYOC (Bring Your Own Credentials) — you provide your Impact Account SID + Auth Token. Used by Walmart, Target, Microsoft, Adobe, Levi's, Airbnb, and thousands of other major brands as their affiliate platform.

✨ Features

• Official Impact REST API — HTTPS, HTTP Basic auth (SID:Token), no scraping
• 8 query types covering the full publisher lifecycle:
  • AccountInfo — your account details (sanity-check creds; always works)
  • Campaigns — list joined advertisers
  • Catalogs — product feeds of joined advertisers
  • Ads — creative assets (banners, text links) of joined advertisers
  • PromoCodes — active coupons from joined advertisers
  • Actions — your own transactions / conversions
  • Reports — list 60+ available report definitions (always populated)
  • RunReport — execute a specific report by reportId with optional date range + custom params
• Built-in pagination — pageSize (max 100 for most endpoints, 1000 for reports) + page
• Date range filters — startDate / endDate for Actions and RunReport
• Custom report parameters — arbitrary customParams object for advanced report calls (e.g. { AdvertiserId: "12345" })
• Auth-only — no proxy needed (no IP-based anti-bot on Impact's API)
• NEVER 0 ITEMS guard — fails with explicit message if no rows returned

🔑 BYOC setup (one-time, ~5 min)

1. Sign in to https://app.impact.com (you need an Impact Publisher account; sign-up is free if you have an audience/site)
2. Go to Account Settings > API Authentication
3. Copy your Account SID (~30 characters, starts with IR)
4. Copy your Auth Token (treat as a password)
5. Paste both into the actor input (both are marked secret)

Auth model: HTTP Basic — Authorization: Basic base64(SID:Token). The SID is sent as the username, the Token as the password.

📥 Input

Parameter	Type	Required	Default	Description
accountSid	string (secret)	Yes	—	Your Impact Account SID (starts with IR)
authToken	string (secret)	Yes	—	Your Impact Auth Token
queryType	enum	No	Reports	One of: AccountInfo, Campaigns, Catalogs, Ads, PromoCodes, Actions, Reports, RunReport
pageSize	integer	No	50	Items per page (max 100 most endpoints, 1000 for RunReport)
page	integer	No	1	Page number
reportId	string	No*	""	Required when queryType=RunReport (e.g. mp_action_listing_fast)
startDate	string	No	""	YYYY-MM-DD for Actions / RunReport
endDate	string	No	""	YYYY-MM-DD for Actions / RunReport
customParams	object	No	{}	Extra query params for RunReport (key/value)

Input example (JSON) — discover available reports

{
  "accountSid": "IRxxxxxxxxxxxxxxxxxxxxxxxx",
  "authToken": "your_auth_token_here",
  "queryType": "Reports",
  "pageSize": 100
}

Input example (JSON) — pull last 30 days of conversions

{
  "accountSid": "IRxxxxxxxxxxxxxxxxxxxxxxxx",
  "authToken": "your_auth_token_here",
  "queryType": "Actions",
  "startDate": "2026-04-15",
  "endDate": "2026-05-15",
  "pageSize": 100
}

Input example (JSON) — execute the fast-action-listing report

{
  "accountSid": "IRxxxxxxxxxxxxxxxxxxxxxxxx",
  "authToken": "your_auth_token_here",
  "queryType": "RunReport",
  "reportId": "mp_action_listing_fast",
  "startDate": "2026-05-01",
  "endDate": "2026-05-15",
  "customParams": {
    "AdvertiserId": "12345"
  }
}

📤 Output

Output schema varies by queryType. Example Campaigns output:

{
  "queryType": "Campaigns",
  "campaignId": "12345",
  "campaignName": "Walmart - US Affiliate Program",
  "advertiserName": "Walmart",
  "isMobileEnabled": true,
  "campaignDescription": "Earn commission on Walmart.com purchases...",
  "contractStatus": "ACTIVE",
  "contractStartDate": "2024-08-15",
  "payoutType": "FLAT_PERCENTAGE",
  "publicCommissionStructure": "1-4% per category",
  "scrapedAt": "2026-05-15T14:30:00Z"
}

Example PromoCodes output:

{
  "queryType": "PromoCodes",
  "promoCodeId": "98765",
  "campaignId": "12345",
  "advertiserName": "Target",
  "code": "SAVE15",
  "description": "15% off home goods orders $50+",
  "discountAmount": 15.0,
  "discountType": "PERCENTAGE",
  "startDate": "2026-05-01",
  "endDate": "2026-05-31",
  "destinationUrl": "https://goto.target.com/...",
  "scrapedAt": "2026-05-15T14:30:00Z"
}

💰 Pricing

Pay-per-event (item-scraped): charged once per row returned. Zero-result queries do not charge.

🚀 Use cases

• Bulk-pull conversion data — pull Actions/Reports into your own data warehouse for attribution analysis
• Active coupon discovery — PromoCodes query lists every live promo across all joined advertisers
• Campaign roster — daily snapshot of which advertisers you've joined and their commission structures
• Catalog refresh — pull product feeds for advertisers (Walmart, Target, etc.) for affiliate site catalogs
• Custom analytics — RunReport with customParams to slice by AdvertiserId / Campaign / DateRange

⚠️ Common errors

Error	Cause	Fix
[IMPACT_API] 401 on /Mediapartners/...	SID or Token wrong	Verify both at app.impact.com > Account Settings > API Authentication
[IMPACT_API] 403 Forbidden	Token revoked OR account suspended	Regenerate token; contact Impact support if suspended
[IMPACT_API] 404 on Reports/{reportId}	reportId doesn't exist or you lack access	Run queryType=Reports first to get the list of available IDs
[FAIL] Zero items returned	Date range too narrow OR no joined advertisers	Widen date range; verify Campaigns returns rows
Mediapartners SID format error	SID missing the IR prefix	Use the full SID exactly as shown in Impact Console

🔒 Privacy

Your SID and Auth Token are sent directly to api.impact.com over HTTPS as HTTP Basic. We never store, log, or proxy them through our servers. Mark both fields as secret in Apify Console.

📚 Related actors

• CJ Affiliate Products — Commission Junction GraphQL (BYOC)
• Rakuten Affiliate Merchants — Rakuten Advertising API (BYOC)
• Awin Multi-Merchant — Awin Publisher API (BYOC)
• Etsy Product Intelligence — Etsy Open API v3 (BYOC)
• ClickBank Marketplace Intelligence — ClickBank digital products

🆕 Changelog

• v1.0 (2026-05-14): Initial release. 8 query types covering AccountInfo / Campaigns / Catalogs / Ads / PromoCodes / Actions / Reports / RunReport. HTTP Basic SID:Token auth. Date range + customParams support for RunReport.

---

Português

🌐 Impact.com Affiliate Network — Campanhas, Catálogos, Relatórios (BYOC)

🔗 Ver na Apify Store

Consulta a API Publisher da Impact.com (api.impact.com) para campanhas, catálogos de produtos, criativos, promo codes, transações e 60+ relatórios. BYOC — você fornece seu Account SID + Auth Token. Plataforma usada por Walmart, Target, Microsoft, Adobe, Levi's, Airbnb e milhares de marcas grandes.

✨ Recursos

• API REST oficial Impact — HTTPS, HTTP Basic auth (SID:Token), sem scraping
• 8 query types cobrindo ciclo completo:
  • AccountInfo — sanity-check de credencial
  • Campaigns — advertisers que você joinou
  • Catalogs — feeds de produtos dos advertisers
  • Ads — criativos (banners, links)
  • PromoCodes — cupons ativos
  • Actions — suas transações/conversões
  • Reports — lista os 60+ relatórios disponíveis
  • RunReport — executa um relatório por reportId com data range + customParams
• Paginação embutida — pageSize (max 100 / 1000 em RunReport) + page
• Filtros de data — startDate / endDate
• Parâmetros customizados — customParams para RunReport avançado
• Auth-only — sem proxy (não há anti-bot por IP)
• NUNCA 0 ITENS — falha alto se nada for retornado

🔑 Setup BYOC (uma vez, ~5 min)

1. Entre em https://app.impact.com (precisa ter conta Publisher; cadastro grátis com site/audiência)
2. Vá em Account Settings > API Authentication
3. Copie seu Account SID (~30 chars, começa com IR)
4. Copie seu Auth Token (trate como senha)
5. Cole ambos no input do actor (marcados como secret)

📥 Input

Parâmetro	Tipo	Obrigatório	Default	Descrição
accountSid	string (secret)	Sim	—	SID Impact (começa com IR)
authToken	string (secret)	Sim	—	Auth Token
queryType	enum	Não	Reports	Um dos 8
pageSize	integer	Não	50	Itens por página (max 100; 1000 em RunReport)
page	integer	Não	1	Página
reportId	string	Não*	""	Obrigatório para RunReport
startDate / endDate	string	Não	""	YYYY-MM-DD para Actions/RunReport
customParams	object	Não	{}	Params extras para RunReport

💰 Cobrança

Pay-per-event item-scraped: cobrado por linha retornada. Query sem resultado não cobra.

🚀 Casos de uso

• Pull em lote de conversões para warehouse próprio
• Descoberta de cupons ativos em todos os advertisers joined
• Snapshot diário de roster de campanhas + comissão
• Refresh de catálogo (Walmart, Target etc.) para sites afiliados
• Analytics customizados com RunReport + customParams

⚠️ Erros comuns

• [IMPACT_API] 401: SID ou Token errado — verificar em app.impact.com > Account Settings > API
• [IMPACT_API] 404 on Reports/{reportId}: rodar queryType=Reports primeiro
• [FAIL] Zero items returned: ampliar range de data; verificar se Campaigns retorna

🔒 Privacidade

Credenciais enviadas diretamente para api.impact.com via HTTPS Basic. Sem armazenamento.

📚 Actors relacionados

• CJ Affiliate Products
• Rakuten Affiliate Merchants
• Awin Multi-Merchant
• Etsy Product Intelligence
• ClickBank Marketplace Intelligence

🆕 Changelog

• v1.0 (2026-05-14): release inicial, 8 query types, Basic SID:Token auth, data range + customParams.