# 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](https://appmanai.com/app). 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

- [Authentication](https://appmanai.com/docs/guide/authentication.md) — keys and rotation.
- [Rate limits & headers](https://appmanai.com/docs/guide/rate-limits.md).
- [Errors & request_id](https://appmanai.com/docs/guide/errors.md).
- [MCP server](https://appmanai.com/docs/guide/mcp.md) — the same data from Claude, Cursor, or any agent.
- The full endpoint list, parameters, and per-endpoint credit cost live in the
  [API reference](https://appmanai.com/docs/reference/).