¿Cómo funciona la verificación de backlinks de un dominio a través de la API?

Envía el dominio como q a una acción como overview, refdomains o backlinks y lee el JSON. Las acciones gratuitas no requieren clave. Las acciones de pago requieren una clave en un encabezado bearer o como key= y cuestan de 1 a 3 créditos por llamada, independientemente del número de filas.

¿Tengo que incluir la clave en el navegador?

No, y no deberías. CORS está abierto, por lo que el navegador puede llamar a la API, pero una clave en el código del cliente es pública para todos los visitantes. Mantén las llamadas de pago en tu servidor y permite que el frontend hable con tu propia ruta.

¿Qué sucede cuando se agotan los créditos?

La API responde con HTTP 402. Una clave faltante o incorrecta devuelve HTTP 401. Trata ambas como señales de detención en lugar de reintentar. Recargas con USDT (TRC-20) desde la página de la cuenta y la misma clave sigue funcionando.

¿Cuántas filas se devuelven por llamada?

Hasta 1.000 filas por llamada, y cada llamada se cobra una vez independientemente del número de filas. Paginación con page y per. La paginación profunda está limitada a 50.000 filas, por lo que para exportaciones más grandes, restringe la consulta con ordenación o una acción diferente.

¿Es DR el mismo número que en Ahrefs?

No. DR aquí es nuestra métrica propia: round(100 log(ref_domains + 1) / log(2 10^7)). Es similar en espíritu a Ahrefs DR o Moz DA, pero se calcula a partir de nuestro propio índice, así que compara tendencias dentro de una sola herramienta, no valores entre herramientas.

¿Qué tan actualizados están los datos de enlaces?

Aproximadamente un mes. El índice se reconstruye aproximadamente una vez al mes, por lo que los enlaces recientes pueden faltar. Si tu producto promete alertas diarias de nuevos enlaces, necesitas un proveedor de rastreo diario y esta API para los números masivos económicos.

¿Hay una cuota mensual o un mínimo?

No suscripción ni mínimo. El crédito es prepagado: 1 crédito cuesta $0.0001, por lo que 1.000 llamadas de un crédito cuestan $0.10. Las cuentas nuevas reciben $100 de crédito gratuito, sin necesidad de tarjeta, solo con inicio de sesión con Google.

Datos de backlinks en JSON: $100 de crédito gratuito, sin tarjeta, inicio de sesión con Google.

798.5 billones de backlinks indexados

Comprobación de backlinks de dominio para tu propio panel

Un endpoint REST que devuelve dominios de referencia, anclas, páginas principales y DR en formato JSON. Construye tu herramienta alrededor de él, y las primeras $100 de llamadas corren por nuestra cuenta.

Obtén $100 gratis Lee el script de DR masivo

Cuatro acciones no requieren clave
Una llamada evalúa hasta 2.000 dominios
CORS abierto, clave bearer o por query-string

GET /api.php?action=domainJSON

$ curl "https://seomasters.dev/api.php?action=overview&q=nytimes.com&key=sk_live_..."

Para qué sirve

Comprobación de backlinks de dominio: cuatro endpoints que conectarás primero

Cada acción toma el objetivo en q y devuelve JSON con una bandera ok. Elige según lo que necesite tu pantalla, no según lo que suene impresionante.

Consultas gratuitas, sin clave

domain, overview, stats y suggest no tienen coste. Úsalos para un widget público o una prueba de humo en CI.

DR masivo para todo un portafolio

bulk_dr evalúa hasta 2.000 dominios por llamada por 1 crédito. Una solicitud nocturna cubre una gran lista de clientes.

Dominios de referencia y anclas

refdomains, anchors y backlinks cuestan 2 créditos por llamada, hasta 1.000 filas cada uno, con page, per, sort y order.

Intersección para tablas de brechas

intersect toma de 2 a 10 dominios y lista quiénes enlazan con ellos conjuntamente. Dos créditos, independientemente del número de filas.

Para quién es

Lo que hay detrás del JSON

Los datos provienen de nuestro propio crawler y de nuestro propio índice de enlaces: 181.132.097 dominios, 2.774.625.913 enlaces entre dominios y aproximadamente 798,5 mil millones de backlinks. No se revenden datos de terceros.

El índice se actualiza aproximadamente una vez al mes. Es posible que falte un enlace colocado la semana pasada, por lo que diseña tu interfaz para mostrar la antigüedad del índice en lugar de prometer datos en tiempo real.

Las respuestas autenticadas incluyen un objeto _credits con el coste de la llamada y tu saldo restante. Regístralo. Tu equipo financiero preguntará en qué se ha gastado el dinero, y la respuesta ya está en cada respuesta.

Hay dos páginas que vale la pena leer antes de escribir código: la referencia del campo DR explica qué es la puntuación de 0 a 100, y la guía del proxy del dashboard muestra dónde debe ir la clave.

¿Es necesario que la primera renderización incluya los números?

Depende de quién lea la página. Una consulta pública que desees que los motores de búsqueda indexen debe incluir sus números en el HTML desde el inicio. Un panel de control que requiere inicio de sesión puede obtener sus filas después de la carga, aunque una tabla vacía en un teléfono lento puede parecer un error.

La opción por defecto que sugerimos es sencilla: tu servidor llama a la API, renderiza las filas y el navegador solo se encarga de ordenar y filtrar. La guía del proxy muestra esta división en Next.js, con el manejador de rutas incluido.

Dónde colocar la clave, una vez más

La clave nunca debe estar en una página que un visitante pueda abrir. Mantén la clave en una variable de entorno del servidor y realiza la llamada desde el código que se ejecuta donde reside ese secreto.

Las herramientas que prometen ocultar una clave en el bundle solo la ocultan de un lector casual, no de alguien con la pestaña de red abierta.

Cadenas de plata que conectan pilares de piedra a través de un valle brumoso representando backlinks de dominio

Una solicitud, de principio a fin

Introduce tu clave. El valor q es el dominio desnudo sin esquema ni ruta.

bash

curl -s "https://seomasters.dev/api.php?action=refdomains&q=example.com&per=100&sort=dr&order=desc" \
  -H "Authorization: Bearer sk_live_..."

# header or ?key= both work
# ok=false or HTTP 401/402 means stop and read the error

Lista de verificación

Antes del primer despliegue en producción

La clave reside en una variable de entorno del lado del servidor, nunca en un bundle del navegador
Cada respuesta se verifica por ok, no solo el estado HTTP
HTTP 401 y 402 no se reintentan automáticamente
_credits se escribe en tu propio registro en cada llamada
La interfaz muestra la renovación mensual, para que nadie interprete los datos como en tiempo real
La paginación se detiene en el límite de 50.000 filas en lugar de bucle infinito

Alcance

Una API de datos de enlaces, no un suite completo de SEO

La investigación de palabras clave, el seguimiento de posiciones y el rastreo diario actualizado se atienden mejor con Ahrefs o Semrush. Ahrefs vende unidades de API dentro de suscripciones a partir de $129 al mes por 200.000 unidades. Esta API, en cambio, cobra los datos de enlaces por llamada.

Buena opción: paneles de control, auditorías, puntuación masiva, herramientas internas
Opción débil: seguimiento de posiciones, volúmenes de palabras clave, alertas de enlaces en vivo
Los datos se actualizan mensualmente, y la documentación lo indica claramente

Cómo funciona

Desde el inicio de sesión hasta un trabajo nocturno

1
Iniciar sesión con Google
La página de la cuenta emite tu clave sk_ y muestra el saldo inicial de $100, con 1.000.000 de créditos.
2
Ejecuta una acción gratuita
Llama a overview para un dominio que conozcas bien. Compara el resultado con lo que esperas antes de construir cualquier cosa.
3
Escribe la capa de recuperación
Envuelve fetch una vez: inyección de clave, verificación de ok, registro de _credits. Consulta las notas sobre paginación para el bucle de paginación.
4
Programa la ejecución
Ejecuta mensualmente para extracciones profundas, diariamente para bulk_dr. La tabla de errores cubre qué hacer cuando falla una ejecución nocturna.

FAQ

Preguntas que hacen los desarrolladores primero

¿Cómo funciona la verificación de backlinks de un dominio a través de la API?: Envía el dominio como q a una acción como overview, refdomains o backlinks y lee el JSON. Las acciones gratuitas no requieren clave. Las acciones de pago requieren una clave en un encabezado bearer o como key= y cuestan de 1 a 3 créditos por llamada, independientemente del número de filas.
¿Tengo que incluir la clave en el navegador?: No, y no deberías. CORS está abierto, por lo que el navegador puede llamar a la API, pero una clave en el código del cliente es pública para todos los visitantes. Mantén las llamadas de pago en tu servidor y permite que el frontend hable con tu propia ruta.
¿Qué sucede cuando se agotan los créditos?: La API responde con HTTP 402. Una clave faltante o incorrecta devuelve HTTP 401. Trata ambas como señales de detención en lugar de reintentar. Recargas con USDT (TRC-20) desde la página de la cuenta y la misma clave sigue funcionando.
¿Cuántas filas se devuelven por llamada?: Hasta 1.000 filas por llamada, y cada llamada se cobra una vez independientemente del número de filas. Paginación con page y per. La paginación profunda está limitada a 50.000 filas, por lo que para exportaciones más grandes, restringe la consulta con ordenación o una acción diferente.
¿Es DR el mismo número que en Ahrefs?: No. DR aquí es nuestra métrica propia: round(100 log(ref_domains + 1) / log(2 10^7)). Es similar en espíritu a Ahrefs DR o Moz DA, pero se calcula a partir de nuestro propio índice, así que compara tendencias dentro de una sola herramienta, no valores entre herramientas.
¿Qué tan actualizados están los datos de enlaces?: Aproximadamente un mes. El índice se reconstruye aproximadamente una vez al mes, por lo que los enlaces recientes pueden faltar. Si tu producto promete alertas diarias de nuevos enlaces, necesitas un proveedor de rastreo diario y esta API para los números masivos económicos.
¿Hay una cuota mensual o un mínimo?: No suscripción ni mínimo. El crédito es prepagado: 1 crédito cuesta $0.0001, por lo que 1.000 llamadas de un crédito cuestan $0.10. Las cuentas nuevas reciben $100 de crédito gratuito, sin necesidad de tarjeta, solo con inicio de sesión con Google.