Skip to content
Ishvana Ishvana Docs

Research Keywords

POST
/api/creative/marketing/intel/keywords

Suggest deterministic ad keywords for a given platform.

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
scope_type
Any of:
string
scope_node_id
Any of:
string

Request Body required

Section titled “Request Body required ”
KeywordResearchRequest

Request body for ad keyword research.

object
platform
required
Platform

Amazon-ads/facebook-ads/bookbub

string
maxKeywords
Maxkeywords
integer
default: 50 >= 10 <= 200

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

KeywordResearchResponse

Response wrapper for keyword research.

object
success
required
Success

Operation success

boolean
keywords
Keywords
Array<object>
KeywordSuggestionData

A single keyword suggestion with metadata.

object
phrase
required
Phrase

Keyword phrase

string
relevanceScore
required
Relevancescore

0-1 relevance

number
competitionEstimate
required
Competitionestimate

Low/medium/high

string
Allowed values: low medium high
category
required
Category

Keyword grouping

string
reasoning
required
Reasoning

Why this keyword

string
total
Total
integer
0
disclaimer
Disclaimer
string
default: AI-estimated suggestions based on genre knowledge, not live market data.
error
Any of:
string

422

Section titled “422 ”

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object