Quickstart - Amazonomics

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

The REST API is part of the Studio plan. If you are on the Pro plan, use the MCP server instead.

Create an API key

Open the dashboard

Go to amazonomics.com/organization/keys.

Create a key

Click Create API Key and give the key a name.

Copy the key

Copy the key and store it in a safe place. The key starts with az_. The dashboard shows it only once.

Make your first request

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

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:

{
  "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

Authentication

How API keys, plans, and errors work.

API reference

All endpoints, parameters, and response schemas.

​Create an API key

​Make your first request

​Next steps

Authentication

API reference

Create an API key

Make your first request

Next steps