Distingue datos de enlaces y pedidos
Una API de datos ofrece observaciones del índice de un proveedor; una API de pedidos crea o consulta operaciones comerciales. Recibir datos no publica enlaces y un recibo no descubre toda la web. El ejemplo usa el formato documentado DataForSEO v3 Backlinks Live. El inspector procesa un archivo local: no pide claves ni envía llamadas pagadas. Los dominios reservados forman una ficción didáctica, no un escaneo real.
Valida la respuesta antes de las filas
La documentación del endpoint separa estado de respuesta, tarea, petición y resultados. El importador requiere una tarea correcta y un resultado. Un error no equivale a cero backlinks; HTTP correcto no basta. Consulta las definiciones de errores. Guarda destino, filtros y agrupación. El proveedor puede consolidar referencias de la misma página, por lo que una fila no cuenta necesariamente cada ancla física.
Lee cuatro observaciones ficticias
El ejemplo declara nueve resultados y entrega cuatro. Los cinco ausentes no están demostrados como perdidos. Las filas representan un indicador follow, atributos sponsored/nofollow, una marca de pérdida y valores desconocidos. Las fechas pertenecen al proveedor, no a una inspección actual. False, cero y ausencia siguen separados; los pares repetidos no se borran. Validar una estructura JSON no autentica su procedencia ni garantiza la veracidad de su contenido.
| Control | Valor ficticio o campo | Interpretación | No deducir |
|---|---|---|---|
| Respuesta y tarea | status_code: 20000 en ambos niveles | Estructura correcta compatible | Nueva comprobación de fuente |
| Total y recibido | total_count: 9; items_count: 4 | Cuatro registros; resultado parcial | Cinco pérdidas o inventario completo |
| Origen y destino | url_from; url_to | Conservar el par exacto | Cada fila cuenta todas las anclas |
| Valores tipados | dofollow: false / null | No declarado y desconocido son distintos | Ausencia significa follow |
| Observación histórica | is_lost: true; last_seen: 2026-10-03 | Pérdida informada por proveedor | Eliminación comprobada hoy |
| Contexto de petición | mode: as_is; backlinks_status_type: all | Guardar alcance con registros | Mismo total con otros filtros |
Limita la integración antes de gastar
Una integración real necesita claves del lado servidor, presupuesto autorizado y parámetros registrados. Revisa precios y límites vigentes, y conserva la respuesta original. La paginación debe mantener el alcance de consulta y comparar filas recibidas con el total. No repitas automáticamente una petición pagada de resultado incierto. Una marca perdida no es una nueva revisión de eliminación. La API de Search Console no incluye el informe de enlaces; tráfico y backlinks no son intercambiables.
Importa localmente y guarda el original
Carga el ejemplo, pega JSON compatible o selecciona un archivo UTF-8. Examina total, filas, aviso parcial y contexto. Exporta CSV para tablas y JSON para tipos: ausencia y texto vacío aparecen como celdas vacías en CSV. Los textos con aspecto de fórmula reciben un apóstrofo protector; el original conserva los valores exactos. Descarga módulo, archivo de línea de comandos y ejemplo en la misma carpeta. Los comandos Node.js siguientes no usan la red. Las hojas CSV son notas, no entradas del importador.
Descargar revisión API resuelta · Descargar revisión API vacía
node backlink-api-cli.mjs backlink-api-example-es.json > backlink-api-records.csv
node backlink-api-cli.mjs backlink-api-example-es.json --json > backlink-api-projection.jsonRespeta los límites de la proyección
Se admite una tarea, un resultado, hasta 1.000 elementos y 512 KiB. Los metadatos seleccionados de petición se limitan a 2.000 caracteres. No se exportan todos los campos: conserva el archivo fuente. Las fechas no se convierten en fechas de publicación. No se consultan URLs, unen páginas de resultados ni autentican cuentas. Un resultado vacío válido solo describe su alcance. Publicación actual, acceso, indexación y posiciones siguen necesitando pruebas separadas.