Developer API

Authentication

Send your key in the Authorization header:

curl https://kamiflavr.com/api/v1/changes \
  -H "Authorization: Bearer pg_live_your_key_here"

Endpoints

GET /api/v1/changes

The changes relevant to you. Optional ?limit= (1–200, default 50).

{
  "object": "list",
  "count": 1,
  "data": [
    {
      "id": "123",
      "source": "Amazon US Fee Schedule",
      "source_url": "https://…",
      "severity": "high",
      "specific": true,
      "summary": "Referral fees rise 1% in one category.",
      "actions": ["Re-check your margins"],
      "affected_categories": ["fees"],
      "detected_at": "2026-07-18T00:00:00.000Z"
    }
  ]
}

GET /api/v1/me

Your plan and what you watch.

{ "object": "account", "tier": "pro", "marketplaces": ["amazon-us"], … }

Prefer push?

If you'd rather be pushed to than poll, use the custom webhook channel — we POST a clean JSON payload to your endpoint the moment a relevant change is found.