API de investigación de palabras clave

Ideas de palabras clave, volumen de búsqueda, CPC, dificultad, sugerencias de autocompletado y agrupación para tus propias herramientas, paneles y agentes de IA. Todos los endpoints devuelven JSON y usan las solicitudes mensuales de tu plan, compartidas con el sitio web.

Inicio rápido

Volumen de búsqueda de dos palabras clave en Vietnam, en tres lenguajes:

curl -X POST https://keywordplanner.vn/api/v1/keywords/volume \
  -H "Authorization: Bearer kwp_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "keywords": ["seo tools", "keyword research"], "country": "vn" }'

const res = await fetch("https://keywordplanner.vn/api/v1/keywords/volume", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.KWP_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ keywords: ["seo tools", "keyword research"], country: "vn" }),
});
const { ok, data, usage } = await res.json();

import os, requests

r = requests.post(
    "https://keywordplanner.vn/api/v1/keywords/volume",
    headers={"Authorization": f"Bearer {os.environ['KWP_API_KEY']}"},
    json={"keywords": ["seo tools", "keyword research"], "country": "vn"},
    timeout=60,
)
print(r.json()["data"]["keywords"])

Autenticación

Crea una clave en Dashboard API y envíala en el encabezado Authorization.

curl https://keywordplanner.vn/api/v1/usage \
  -H "Authorization: Bearer kwp_live_YOUR_KEY"

Límites

• Starter: 10,000 créditos / mes ($9, compartidas con el sitio web)
• Pro: 25,000 créditos / mes ($19, compartidas con el sitio web)
• Free y Lite no incluyen la API.
• Starter y Pro: como máximo el 10% de los créditos mensuales al día, 15 llamadas por minuto y 5 solicitudes simultáneas.
• Encabezados de respuesta: X-Plan, X-Requests-Limit-Month, X-Requests-Remaining-Month, Retry-After

Endpoints

{ "keywords": ["keyword planner"], "country": "vn", "lang": "vi", "targetSite": "example.com", "sortBy": "resultDESC", "limit": 200 }

{ "keywords": ["seo tools", "keyword research"], "country": "us" }

{ "keywords": "seo tools\nfree seo tools\nkeyword planner" }

{ "keyword": "coffee machine", "lang": "en" }

Respuesta

{
  "ok": true,
  "data": {
    "keywords": [
      { "keyword": "keyword planner", "results": 12100, "trend": [9900, 12100, …], "competition_level": 34,
        "minCPC": 4200, "maxCPC": 15800, "difficulty": 48.2, "length": 2, "isQuestion": false, "keywordType": "exact" }
    ],
    "traffic": [{ "time": "2026-09", "month": 9, "year": 2026, "totalImpression": 154000 }]
  },
  "usage": { "plan": "Starter", "units": 2, "used": 121, "limit": 10000, "remaining": 9879 }
}

Los valores de CPC están en VND. trend contiene 12 meses, del más antiguo al más reciente.

Errores

Preguntas frecuentes