> ## Documentation Index
> Fetch the complete documentation index at: https://docs.amazonomics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Make your first API request in five minutes

This guide shows how to get an API key and run your first search.

<Note>
  The REST API is part of the Studio plan. If you are on the Pro plan, use the
  [MCP server](/mcp/overview) instead.
</Note>

## Create an API key

<Steps>
  <Step title="Open the dashboard">
    Go to [amazonomics.com/organization/keys](https://amazonomics.com/organization/keys).
  </Step>

  <Step title="Create a key">
    Click **Create API Key** and give the key a name.
  </Step>

  <Step title="Copy the key">
    Copy the key and store it in a safe place. The key starts with `az_`. The
    dashboard shows it only once.
  </Step>
</Steps>

## Make your first request

Send the key in the `Authorization` header as a bearer token:

```bash theme={null}
curl "https://api.amazonomics.com/v1/search/keywords?query=matcha&limit=3" \
  -H "Authorization: Bearer az_your_key_here"
```

The response contains one result per matched search term:

```json theme={null}
{
  "data": [
    {
      "search_term": "matcha powder",
      "normalized_search_term": "matcha powder",
      "data": {
        "06-2026": 941,
        "07-2026": 812
      },
      "summary": {
        "total_periods": 24,
        "best_rank": 655,
        "worst_rank": 1204,
        "avg_rank": 903,
        "latest_rank": 812,
        "latest_period": "07-2026"
      },
      "latest_data": {
        "brands": ["Jade Leaf", "Naoki"],
        "products": [
          {
            "asin": "B01G7SLZ4U",
            "title": "Jade Leaf Organic Matcha Green Tea Powder",
            "click_share": 0.12,
            "conversion_share": 0.15
          }
        ],
        "categories": ["Grocery & Gourmet Food"]
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "page_size": 3,
    "total_count": 128,
    "total_pages": 43,
    "has_next": true,
    "has_previous": false
  },
  "error": null
}
```

Lower ranks are better. Rank 1 is the most searched term in that period.

## Next steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/authentication">
    How API keys, plans, and errors work.
  </Card>

  <Card title="API reference" icon="book" href="/api-reference/introduction">
    All endpoints, parameters, and response schemas.
  </Card>
</CardGroup>