Volumen de búsqueda

Refresh search volume data

seo_rankings.volume.fetch

Fetches from DataForSEO (paid; one call per 700 keywords) the monthly search volume, CPC, competition and 12-month trend of the project's ACTIVE keywords (or of the keyword_ids given, active ones only) and stores them on each keyword, using the location and language of the project's first engine. Returns how many keywords were requested and updated, how many failed on the provider side, and the calls made. Use it after adding keywords without search volume or to refresh stale data; it does not measure positions. Not available in demo organizations: 403 demo_read_only, already on the dry run. Outside the app it needs a dry run and its confirm_token (it pays DataForSEO).

Pide confirmación: primero dry_run: true (vista previa y confirm_token, que vale 10 minutos y una sola vez), después el mismo cuerpo con confirm_token. En unas pocas, solo con ciertos datos: la descripción dice cuándo. Por qué y cómo: Vista previa y confirmación.

Alcance

seo_rankings:write

Permiso

Editar en el módulo

Tool del MCP

seo_rankings_volume_fetchEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_rankings.volume.fetch".

Costo declarado: hasta 502 lecturas y 500 escrituras por llamada (cuentan en el cupo diario). Toca una plataforma externa (dataforseo): cuenta en el cupo de operaciones externas.

Parámetros

Respuesta

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/seo/rankings/projects/{project_id}/volume" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "dry_run": true
}'

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar. En la práctica esta operación no se simula (toca otra plataforma): responde 409 sandbox_external_unavailable.