Generate Keyword Ideas

This endpoint generates keyword ideas related to a given input keyword. It helps users discover relevant search terms along with useful insights such as search volume, cost-per-click (CPC), and monthly trends. Ideal for planning and optimizing Google Ads campaigns based on real search behavior.

POST /gads/generate_keyword_ideas

Generate Keyword Ideas

cURL

curl --request POST \
  --url https://public.plai.io/gads/generate_keyword_ideas \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "keyword": "<string>",
  "languageId": "<string>",
  "locationIds": [
    "<string>"
  ]
}
'

200

{
  "success": true,
  "results": {
    "success": true,
    "keywords": [
      {
        "keyword": "<string>",
        "searchVolume": 123,
        "cpc": 123
      }
    ],
    "error": "<string>"
  }
}

Request Body

keyword · string · required

Keyword for generating similar keyword ideas.

languageId · string

languageId for generating keyword ideas.

You can find supported `languageIds` by downloading the file and use the column `Criterion ID` as the `languageId`

Default languageId is English.

locationIds · string[]

Location IDs for generating keyword ideas

You can retrieve the appropriate locationId using the Get Location API.

Default locationId is United States.

Response

success · boolean

Indicates that the HTTP response was successful (status code 200 OK).

results · object

Show Results Object

success · boolean

Indicates whether the specific operation or API action was successful.

keywords · object[]

Show Keyword Object

keyword · string

The generated keyword idea related to the input keyword.

Example: "best running shoes"

searchVolume · number

Average monthly search volume for the keyword.

Example: 19000

cpc · number

Estimated cost-per-click value for the keyword.

This is a numerical score used to help rank keyword performance.

error · string

Error string if something went wrong