Skip to main content

Suggest keywords

Using our SalesOptimizer API, you can call our API to suggest keywords based on a given ASIN using a number of different sources. This can help in optimizing your product title and description or help target keywords during advertisement.

Requirements​

Calling this API endpoint requires a valid API key that you can generated on the SalesOptimizer dashboard (SOON). Furthermore, each API call requires a valid ASIN code, the amount of suggestions you would like to receive and a valid extension.

Parameters​

Calling the http://salesoptimizer.assitantslab.com/api/asin/suggestkeyword endpoint requires a total of 4 parameters:

  • key → This is your API key
  • asin → A valid ASIN code
  • number_of_suggestions → A number ranging from 1 to 1000 that represents how many keywords you would like to be suggested.
  • extension → What marketplace extension you would like to target (such as com, de, co.uk)

Example API call​

Python​

example.py
import requests

# API endpoint URL
url = "http://salesoptimizer.assistantslab.com/api/asin/suggestkeyword"

# Parameters
payload = {
    "key": "your_api_key",
    "asin": "B01ABCDEF",
    "number_of_suggestions": 5,
    "extension": "com"
}

# Send the POST request
response = requests.post(url, json=payload)

# Check the response status code
if response.status_code == 200:
    # Successful response
    data = response.json()
    status = data.get("status")

    if status == "success":
        suggestions = data.get("response")[0]
        sources = data.get("sources")
        print("Suggestions:", suggestions)
        print("Sources:", sources)
    else:
        print("Error: Something went wrong")
else:
    # Error response
    error_message = response.json().get("error")
    print("Error:", error_message)

API-response​

The response of the API can look like this:

{
    "response": [
        [
            "shutter island thriller",
            "addictive",
            "film psycho thriller"
        ]
    ],
    "sources": [
        "amazon",
        "google"
    ],
    "status": "success"
}

The response contains the suggestions in response and lists the sources used in sources. Possible sources:

  • amazon → Generated using Amazon tools
  • google → Generated using Google and other search-engines
  • generated → Generated by our in-house developed AI

Issues​

Are you experiencing any issues calling our API? Feel free to contact our support team.