POST

List Suggested Keywords


This method requests keyword suggestions for a specified phrase. You provide statistical data about the requested keyword and a list of similar keywords so the user can compare the SEO strength of the suggested keywords.

Wix calls this method when a Wix user requests data about a keyword via the SEO page of the Dashboard.

Endpoint
POST
{DEPLOYMENT-URI}/v1/list-suggested-keywords
Body Params
keywordstringmaxLength 256

Keyword to analyze for SEO strength.


countryCodestringformat COUNTRY

Specific country for analysis.

2-letter country code in ISO-3166 alpha-2 format.

Response Object
dataArray <SuggestedKeywords>

Analysis of the keyword.


quotaQuota

Updated quota after request processed.

List suggested keywords
Request
cURL
curl POST https://www.provider.example.com/v1/list-suggested-keywords \ -H 'Content-Type: application/json;charset=UTF-8' \ -H 'Authorization: <AUTH>' \ --data '{ "keyword": "ice cream", "countryCode": "US" }'
Response
JSON
{ "data": [ { "keyword": "ice cream", "volume": 550000, "difficulty": 100, "latestTrends": [ 0.3, 0.2, 0.24, 0.16, 0.2, 0.2, 0.44, 0.36, 0.36, 0.36, 0.24, 0.2 ], "searcherIntent": ["TRANSACTIONAL"] }, { "keyword": "ice cream near me", "volume": 1500000, "difficulty": 83, "latestTrends": [ 0.66, 0.44, 0.3, 0.3, 0.3, 0.3, 0.54, 0.66, 0.81, 1.0, 1.0, 0.66 ], "searcherIntent": ["TRANSACTIONAL"] }, { "keyword": "little debbie ice cream", "volume": 110000, "difficulty": 50, "latestTrends": [ 0.0, 0.06, 0.16, 0.07, 0.66, 1.0, 0.16, 0.11, 0.09, 0.07, 0.09, 0.04 ], "searcherIntent": ["INFORMATIONAL"] }, { "keyword": "ice cream cake strain", "volume": 74000, "difficulty": 43, "latestTrends": [ 1.0, 1.0, 1.0, 0.81, 0.81, 0.66, 0.81, 0.81, 0.66, 0.66, 0.66, 0.66 ], "searcherIntent": ["INFORMATIONAL"] }, { "keyword": "ice cream places near me", "volume": 74000, "difficulty": 61, "latestTrends": [ 0.44, 0.3, 0.13, 0.16, 0.2, 0.3, 0.36, 0.44, 1.0, 0.66, 0.66, 0.44 ], "searcherIntent": ["TRANSACTIONAL"] }, { "keyword": "jeni's ice cream", "volume": 74000, "difficulty": 70, "latestTrends": [ 0.67, 0.54, 0.54, 0.54, 0.54, 0.54, 0.67, 0.67, 0.81, 1.0, 0.16, 0.16 ], "searcherIntent": ["NAVIGATIONAL"] }, { "keyword": "jenis ice cream", "volume": 74000, "difficulty": 70, "latestTrends": [ 0.36, 0.55, 0.45, 0.67, 0.55, 0.45, 0.82, 0.45, 0.67, 0.67, 1.0, 0.82 ], "searcherIntent": ["NAVIGATIONAL"] }, { "keyword": "rolled ice cream", "volume": 74000, "difficulty": 49, "latestTrends": [ 0.54, 0.54, 0.44, 0.44, 0.54, 0.44, 0.54, 0.54, 0.67, 0.67, 0.81, 0.81 ], "searcherIntent": ["INFORMATIONAL"] }, { "keyword": "ice cream cake", "volume": 60500, "difficulty": 71, "latestTrends": [ 0.66, 0.54, 0.54, 0.54, 0.66, 0.54, 0.66, 0.66, 0.81, 0.81, 1.0, 0.81 ], "searcherIntent": ["INFORMATIONAL"] }, { "keyword": "ice cream shop", "volume": 60500, "difficulty": 48, "latestTrends": [ 0.24, 0.24, 0.16, 0.16, 0.3, 0.3, 0.44, 0.24, 0.3, 1.0, 0.16, 0.66 ], "searcherIntent": ["COMMERCIAL"] }, { "keyword": "museum of ice cream", "volume": 60500, "difficulty": 80, "latestTrends": [ 0.66, 0.54, 0.54, 0.54, 0.66, 0.66, 1.0, 0.66, 0.54, 1.0, 0.66, 0.66 ], "searcherIntent": ["NAVIGATIONAL"] } ], "quota": { "remaining": 9, "limit": 10, "startDate": "2022-11-04T07:04:35Z", "endDate": "2022-11-05T07:04:35Z", "isPaidPlan": false, "paidPlan": false } }
Errors
QuotaLimitReachedobjectstatus code: 429
MissingTokenobjectstatus code: 401
Did this help?