Docs

How Loopwing talks to your marketplaces, ticks on a heartbeat, and behaves when rate-limited.

Three sections, all of them operational truth. The platforms we connect to, the exact cadence of every beat, and the rules the agent follows under a 429.

Supported marketplaces

Two platforms. Every channel we know is one of them.

Loopwing is opinionated about where it operates. Each platform gets a single official API surface that the agent owns end to end — no scraped endpoints, no third-party gateways.

Admin API
Shopify
One source of truth for the storefront side of every Loopwing tenant.
  • Products · variants · collections
  • Inventory levels per location
  • Orders · fulfillments · returns
  • Pricing rules per channel
  • Draft orders · transfers
SP-API
Amazon Seller Central
The Selling Partner API powers every Amazon-side action Loopwing takes — repricing, inventory, orders, and reviews.
  • Catalog Items · Listings
  • Inventory · FBA Inbound
  • Pricing · Competitive Pricing
  • Reports · Sales & Traffic
  • Orders · Notifications
  • Messaging · Brand Analytics
Amazon SP-API scopes
We ask for the scopes a store actually needs, not a fixed maximal set.
CatalogInventoryPricingReportsOrdersListingsMessagingNotifications

Loopwing reads your store’s policy active set when it enrolls and requests each scope the modules you enabled actually require. You see the scope list we requested, you approve it once, and it stays stable as long as your policy file does — no opportunistic re-prompts.

Agent heartbeat

Every beat on a real, named cadence.

Each module runs on a deliberate interval — fast enough to catch drift, slow enough to stay inside per-store rate limits. Listed is the cadence the agent commits to, not aspiration.

Five modules · five cadences
Cadence  ·  Module  ·  What the beat does
01Every 15 minutes
InventoryRecompute stock cover across Shopify + FBA; raise a transfer or PO when cover drops below your floor.
02Every 30 minutes
PricingPull competitor prices, apply your floor / ceiling / MAP / kill-set, queue moves for approval, write back defensible prices.
03Every 5 minutes
ReviewsTriage new reviews by stars and topic, draft replies in your voice, queue for one-tap approval.
04Every 60 minutes
AdsScore every active ad set against your ACoS ceiling; pause losers, reallocate to the next best performer.
05Daily
Supplier checksPull supplier confirmations, line them up against your inbound plan, flag slipped ETAs with a stock-cover delta.
Rate-limit expectations

Per-store caps. Predictable behavior under a 429.

Each platform enforces its own rate ceiling. Loopwing reads it live, queues work the moment it’s told to back off, and resumes the moment the window reopens — without losing or duplicating anything.

Marketplace
Shopify Admin API
Bucket-based call / second rate

Shopify enforces leaky-bucket limits that replenish per plan tier. Loopwing reads your store’s bucket state on every call and stays inside it — never bursts it. On a 429, the agent reads the response, parks the queued work, and resumes once the bucket refills; nothing drops, nothing double-fires.

  • Pre-flight budget check before every batch
  • Single in-flight token per store
  • 429 → wait + resume with jitter
  • No retry storms, no double-spend
Marketplace
Amazon Selling Partner API
Per-rate / per-quota ceiling

Amazon SP-API tracks distinct rate and quota objects per operation (orders, pricing, inventory, reports). Loopwing enrolls the store once and reads the live ceiling for each object on every call. On a 429, the agent waits for Retry-After, deduplicates any retried request, and surfaces both the rate-limit header and the dedicated x-amzn-RequestId so you can audit exactly what was deferred.

  • Per-operation rate ceiling tracked live
  • Retry uses Retry-After + exponential backoff
  • Request IDs logged per call
  • Work queues, never lost
Agent behavior under back-pressure
Queue, dedupe, retry with jitter. Never miss a heartbeat on a 429.

On any 429 — Shopify bucket exhaustion, Amazon SP-API rate or quota object, or a transient network error treated conservatively — Loopwing parks the affected work, deduplicates any retried operation, and resumes once the platform tells us it’s ready. Heartbeats stay on schedule; nothing writes twice.

Every deferred call is logged with the request ID the platform returns, so when your store dashboard surfaces a rate-limit event, you can match it to a Loopwing job in seconds.

Want it on a real store?
Bring the marketplaces you sell on. We’ll bring the agent.

One short email, an onboarding call inside a day, and Loopwing running against live APIs by close of business.