GET /amazon/suggestions

Returns the search bar keyword suggestions using as input the target keyword.

Endpoint currently in beta release. For any bug please reach [e-mail]

Request Headers

X-API-Key: your_api_key_here

Query Parameters

• marketplace (required, string) - Amazon marketplace in ISO 3166-1 alpha-2. (Note that UK is “uk” not “gb”)

• keyword(required, string) - Amazon search target keyword

Responses Codes

Status: 200 OK
Status: 400 Bad Request
Status: 401 Unauthorized
Status: 500 Internal Server Error

Request URL Example

https://api.asgardata.com/amazon/suggestions?marketplace=us&keyword=apple

Response Example

{
  "ts": 1724702357786,
  "rid": "85bfa3dd-e4dd-4b18-b185-111ca5aafb39",
  "params": {
    "marketplace": "us",
    "keyword": "apple"
  },
  "result": {
    "keywords": [
      "apple watch bands for women",
      "apple watch charger",
      "apple airtag",
      "apple charger",
      "apple cider vinegar",
      "apple watch band",
      "apple slicer",
      "apple watch",
      "apple charger cord",
      "apple corer"
    ]
  }
}

Response example without keyword suggestions

{
  "ts": 1724702370456,
  "rid": "b3bfa3dd-e4dd-4b18-b185-111ca5aafb39",
  "params": {
    "marketplace": "us",
    "keyword": "apple 3r23453245"
  },
  "result": {}
}

Bad input keywords (no suggestion results) will be charged anyway.