run_keyword_research

Avvia una ricerca keyword e ritorna un job_id: richiama lo stesso tool passando job_id per avere i risultati (volume, CPC, intent, difficulty = indice di competizione Google Ads 0-100, NON difficoltà SEO), di solito pronti entro un paio di minuti. mode: related (da una seed), list (volumi di una lista), domain (keyword di un dominio), gap (keyword del competitor non coperte dal dominio). Con project_id marca le keyword già tracciate. Il ritiro con job_id non consuma quota. AZIONE A PAGAMENTO: consuma 1 unità della quota mensile del piano e 1 azione MCP (tetto dedicato). Usa get_usage per i crediti residui.

post/api/v1/run_keyword_research

Request

  • Base URL: https://app.miraqo.io
  • URL: https://app.miraqo.io/api/v1/run_keyword_research
  • Auth: HTTP bearer

Request body

mode'related' | 'list' | 'domain' | 'gap'
job_idinteger

ritira una ricerca già avviata

seedstring

keyword di partenza (mode=related)

keywordsstring[]

lista keyword (mode=list)

domainstring

dominio (mode=domain/gap)

competitorstring

dominio competitor (mode=gap)

location_codeinteger

default 2380 (Italia)

language_codestring

default 'it'

project_idinteger
organization_idinteger

Response

ok=true, risultato in data

Changes

No recorded changes to this operation across all 1 revision of this API.