API Documentation

Base URL: https://ima-devapi.pages.dev · All requests and responses are JSON.

1. Issue a key

POST /api/keys — mint a free API key (100 req/day). Max 3 keys per email.

curl -X POST https://ima-devapi.pages.dev/api/keys \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com"}'

→ 201 {"api_key":"hk_…","tier":"free","daily_limit":100,
       "note":"Free tier: 100 requests/day…","docs":"https://ima-devapi.pages.dev/docs"}

2. Generate hooks

POST /api/v1/hooks — topic (2–80 chars), count (1–10, default 5).

curl -X POST https://ima-devapi.pages.dev/api/v1/hooks \
  -H "Content-Type: application/json" \
  -d '{"api_key":"hk_…","topic":"roguelike deckbuilder","count":3}'

→ 200 {"topic":"roguelike deckbuilder","count":3,
  "hooks":["Why 90% of devs get roguelike deckbuilder wrong (and how to be the 10%).", …],
  "usage":{"used_today":4,"daily_limit":100,"remaining":96},"tier":"free"}

Every response carries X-RateLimit-Limit and X-RateLimit-Remaining headers. Quotas reset at 00:00 UTC.

3. Check usage

GET /api/usage?api_key=hk_…

{"tier":"free","daily_limit":100,"used_today":4,"remaining":96,"resets_at":"2026-09-22T23:59:59Z"}

Error codes

Status	Meaning
`400`	Bad request — missing/invalid topic or email.
`401`	Missing or invalid API key.
`429`	Daily quota exhausted (or 3-keys-per-email cap). Includes `resets_at`.
`503`	Service at capacity — key issuance paused. Fail-closed, retry later.

Tiers & limits

Tier	Price	Daily requests
Free	$0	100
Pro	$19/mo	10,000
Scale	$99/mo	100,000

Manual upgrades, no SLA. Paid tiers are activated manually within 24 hours of payment (email confirmation sent). This is an indie-run API: no uptime or latency guarantees. Cancel anytime by emailing indiemarketingarsenal@proton.me.

RapidAPI

Prefer RapidAPI's marketplace? See RAPIDAPI-HANDOFF.md in the project repo for the exact listing steps.