Quickstart ​

From zero to your first response in a couple of minutes. Every endpoint is a single authenticated HTTP call — no SDK required.

1. Get an API key ​

Create a key in your dashboard. New accounts start with free credits, no card required. Keys look like appmanai_live_… and spend credits from your balance.

Copy the secret when it's shown — it's only displayed once.

2. Make your first request ​

Send the key as a Bearer token. Looking up supported countries is free — reference data costs nothing, so you can build a valid request before spending anything:

bash
curl https://appmanai.com/api/v1/resources/countries \
  -H "Authorization: Bearer appmanai_live_xxx"

3. Query the stores ​

Every read is a GET with query parameters. store is ios or android and country is an ISO code like US. For example, search apps:

bash
curl -G "https://appmanai.com/api/v1/apps/search" \
  -H "Authorization: Bearer appmanai_live_xxx" \
  --data-urlencode "store=ios" \
  --data-urlencode "country=US" \
  --data-urlencode "q=habit tracker" \
  --data-urlencode "limit=10"

Parameters that take a list are repeated:

bash
curl -G "https://appmanai.com/api/v1/keywords/metrics/sap/batch" \
  -H "Authorization: Bearer appmanai_live_xxx" \
  --data-urlencode "country=US" \
  --data-urlencode "keywords=habit tracker" \
  --data-urlencode "keywords=daily planner"

The two /generate/* endpoints are the exception — they are POST with a JSON body, because they take draft copy rather than a lookup key.

Every response carries a few headers worth reading:

  • X-Request-Id — the id of this request; quote it in any support report.
  • X-Credit-Cost / X-Credit-Balance — what the call cost and what's left. A call that finds no data costs 0 and also carries X-Credit-Waived: no-data.
  • X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset — your current rate-limit window.

Next steps ​