Independent Developer · Amazon Ads API Integration

Open-source tooling for Amazon Sponsored Ads automation.

AdLoop is a one-person project that connects to the Amazon Ads API to run bid rules, harvest search-term reports, and surface ACOS / ROAS dashboards — built end-to-end by a single developer on a public GitHub Pages site.

  • · Sponsored Products / Brands / Display
  • · Reporting & bulk operations
  • · OAuth2 LwA flow, refresh-token rotation

About the project

AdLoop is a personal project. There is no company behind it. The goal is to demonstrate a clean, well-scoped use of the Amazon Ads API: read campaign performance, write bid adjustments, and present the results in a way that is reproducible by other developers.

Everything visible on this site — landing page, code samples, issue tracker — is part of the public application for Amazon Ads API access. The site itself is a static GitHub Pages deployment, committed and version-controlled in the open.

What AdLoop will do

A narrow, well-defined scope. Nothing here touches seller accounts, order data, or brand-only endpoints.

📊 Performance dashboards

Daily pulls of impressions, clicks, spend, sales, ACOS, ROAS. Aggregated into a local SQLite store, rendered as static charts.

🤖 Bid rules

Configurable rules: raise bids on top-converting search terms, lower bids on ACOS outliers, pause campaigns that exceed a daily spend cap.

🧹 Search-term harvest

Periodic download of the search-term report. Surface negative-match candidates and new keyword opportunities for manual review.

📦 Bulk sheets

Use the Amazon Ads Bulksheets endpoint to stage hundreds of edits, then upload in one call instead of looping the REST API.

🛡 Guardrails

Every write goes through a dry-run preview, a diff log, and a per-account rate-limit budget. No silent changes.

🔐 Secure secrets

Refresh tokens stored in the local OS keychain. No credentials in the repository, no credentials on the public Pages site.

How the Amazon Ads API is used

The plan below maps every automation back to a specific public endpoint. Nothing is invented or speculative.

CapabilityEndpoint familyRead / Write
Sponsored Products campaign list & state/sp/campaignsRead · Write
Ad-group & keyword management/sp/adGroups · /sp/keywordsRead · Write
Bid recommendations & overrides/sp/keywords/bidRecommendationsRead · Write
Search-term report/sp/targets/searchTermReportRead
Performance reports (campaign, ad group, keyword)/reporting/reportsRead
Bulk upload of staged edits/bulksheetsWrite
Profile / marketplace selection/profilesRead

Endpoints reserved for Brand-Registered sellers (Brand Analytics, Marketing Stream, Reach, Demographics) are out of scope and will not be requested. AdLoop only touches Sponsored Ads surfaces.

Roadmap

  1. Now — Static portfolio site live on GitHub Pages; Amazon Ads API access application submitted.
  2. Next 2 weeks — OAuth2 LwA flow wired up locally; first read-only call to /sp/campaigns against the maintainer's own test profile.
  3. Week 3–4 — Performance-report pull into a local SQLite store; minimal dashboard rendered from the static site.
  4. Month 2 — Bid-rule engine with dry-run preview; search-term harvest on a schedule.
  5. Month 3 — Bulksheets workflow for bulk edits; published v1.0 release.

Contact

For questions about the Amazon Ads API application, or to request a demo once the integration is live, reach the maintainer through any of the channels below.

  • GitHub Issues: the preferred channel for technical questions
  • Email: maintainer [at] adloop [dot] dev
  • Response time: best-effort, typically within 3 business days