Referencia
Campos del puntaje de fichas de herramientas, uno por uno
Diseña tu tabla de fichas una vez y la tarea mensual se escribe sola. Aquí tienes cada columna de puntaje de enlace que puede almacenar un directorio, y la llamada que la completa.
Equipo de investigación de SEO Tools AI ·
Las columnas, de un vistazo
| Columna | Completada por | Créditos | Actualización |
|---|---|---|---|
| dr | bulk_dr, hasta 2.000 dominios | 1 | Mensual |
| dr_checked_on | Tu propio trabajo, el día que lo obtuviste | 0 | Cada ejecución |
| ref_domains | refdomains, ordenado según tu elección | 2 | Mensual, solo para las fichas destacadas |
| top_anchors | anchors | 2 | Trimestral |
| top_pages | toppages | 2 | Trimestral |
| overview_blob | overview (gratis, sin clave) | 0 | Bajo demanda |
| rival_overlap | intersect, de 2 a 10 dominios | 2 | Cuando añades una herramienta |
Las columnas que se ganan su espacio
Empieza con dos. dr es la clave de ordenación, y dr_checked_on es la columna de honestidad.
Un puntaje sin fecha parece un hecho, y un mes después es un rumor. La fecha lo evita, y también permite que tu trabajo salte las filas que actualizó hace una hora tras un fallo.
Trata todo lo demás como opcional. Un sitio de comparación que muestra los dominios de referencia junto a la calificación ofrece a los lectores un segundo número para cotejar, lo cual es más útil que una insignia más bonita. Nuestra herramienta de análisis de backlinks muestra cómo se ve esto frente a otros verificadores.
Asocia las columnas con el glosario para que los lectores vean las mismas palabras que usas en la oficina central, y con la receta de sincronización cuando estés listo para completarlas.
Columnas para los enlaces que ofrece un directorio
Los puntajes describen la herramienta. Un directorio también otorga enlaces, y esos merecen una columna propia. Los catálogos que piden un enlace de vuelta son comunes, así que la pregunta llegará antes de lo que imaginas.
Empieza con un campo de sí o no que registre el enlace de retorno. Antes de escribirlo, verifica el sitio listado tú mismo, porque una respuesta recordada es lo primero que falla en una lista de unas pocas cientos de filas.
Una columna de enlace recíproco
Añade reciprocal_link como una columna de sí o no que indique si el sitio de la herramienta listada enlaza de vuelta hacia ti. Digamos que mantienes 300 herramientas y 40 de ellas pidieron un enlace a cambio. Esa columna te dice qué fichas descansan en un favor, y lo hace antes de que un lector pregunte.
Mantén la columna fuera del orden de puntaje. Describe la relación, no la herramienta, por lo que mezclarla en una clasificación haría que el orden fuera más difícil de explicar después.
Una columna de estado para los enlaces que publicas
Registra outbound_status con el estado HTTP de cada enlace que publicas, más la fecha en que lo verificaste por última vez. Una ficha que devuelve un 404 es una promesa rota para el lector, y nadie más lo notará por ti.
La verificación puede formar parte de la misma ejecución mensual que la actualización del puntaje. Añades una columna y no un nuevo horario, que es el mantenimiento más barato que puede comprar un directorio.
Escribe la promesa que te dieron
Cuando un catálogo pide un enlace a cambio, anota la fecha, la página y la redacción exacta de la solicitud en una columna link_note. Una nota simple tarda un minuto en escribirse y ahorra una discusión seis meses después.
No prometas una ubicación que no puedas mantener. Si el enlace de retorno nunca se añade, el movimiento honesto es marcar la fila y dejar el puntaje intacto.
Mantener la ubicación pagada separada
Si una ficha pagó por su espacio, almacena un valor placement junto al puntaje y nunca dejes que el puntaje decida el orden por sí solo. Un dr alto no debe ser la única razón por la que una fila pagada se sitúa por encima de una mejor.
Muestra la bandera de pago junto al puntaje, para que cualquiera que ordene la página vea ambos. Un lector que encuentra la etiqueta es un lector que sigue confiando en el resto de la lista.
Los parámetros de solicitud que realmente usarás
Estos son los parámetros de la API, en el orden que necesita un trabajo de sincronización.
action what to do: domain, overview, bulk_dr, refdomains, anchors ...
q one domain, for single-domain actions
domains comma list, for bulk_dr (GET) or send it as a POST body
key your sk_ key, or use the Authorization: Bearer header
page which page of rows
per rows per page, 10 to 5000, up to 1,000 rows per billed call
sort column to sort by
order asc or descNomenclatura y tipos que envejecen bien
Nombra las columnas según lo que contienen, no según un proveedor. dr está bien para el nuestro, pero si más tarde añades una segunda métrica, dr_ours y da_moz te ahorrarán una migración.
Almacena la calificación como un entero de 0 a 100, la fecha como una cadena ISO como 2026-10-01, y los conteos como enteros. Una columna de texto que contiene 1.2k es una trampa para la primera persona que la ordene.
Mantén también una columna source, con un valor corto como seotoolsai. Cuesta unos pocos bytes y responde a la pregunta que hará cualquier editor futuro.
Cada respuesta lleva ok. Las autenticadas también llevan _credits, con el coste de esa llamada y tu saldo restante. Registra ambos. Antes de mapear cualquier otro campo a una columna, haz una llamada domain gratuita y lee el JSON tú mismo.
Configura la tabla en cinco pasos
Nombra las columnas primero
Escribe la lista de columnas antes de tocar una clave de API, y nombra cada columna según lo que contiene. Deja los nombres de los proveedores fuera de los nombres de las columnas, para que una métrica posterior no obligue a un renombrado.
Haz una llamada gratuita
Ejecuta overview para un solo dominio. No necesita clave, así que puedes leer el JSON y verificar los nombres de los campos contra tu tabla antes de gastar cualquier crédito.
Añade el puntaje y su fecha
Almacena dr como un entero y dr_checked_on como una fecha ISO. Esas dos columnas son el mínimo para un puntaje que un lector pueda confiar.
Prueba con veinte filas
Envía bulk_dr para veinte fichas que conozcas. Compara tres resultados a mano con la acción domain gratuita, y solo entonces ejecuta la lista completa.
Añade columnas de detalle para las filas destacadas
Los dominios de referencia y los anclajes cuestan 2 créditos por llamada, así que obténlos para las fichas que muestres en detalle. El puntaje de 1 crédito aún puede cubrir todas las demás filas.
Ejemplo práctico: un registro de ficha hipotético
Este es un ejemplo inventado, no una ficha real. Imagina un directorio llamado ToolShelf con una ficha para un producto ficticio, example-seo.test.
Su registro contiene dr 41, dr_checked_on 2026-10-01 y ref_domains 1.000. Eso encaja con la fórmula pública, ya que log(1001) dividido por log(20.000.000) multiplicado por 100 se redondea a 41.
Un mes después, el trabajo vuelve a obtener los datos y encuentra 1.800 dominios de referencia, por lo que la calificación se convierte en 45. Solo cambian dr y la fecha. El texto de la reseña, las capturas de pantalla y las notas del editor permanecen exactamente como se escribieron, porque el puntaje no las toca.
Qué fichas merecen un puntaje, y hasta qué profundidad
No todas las fichas necesitan la misma profundidad. Un directorio con unas pocas cientos de herramientas puede puntuar cada fila, pero las llamadas de detalle son una decisión separada con un coste separado.
Puntuar cada fila, incluso las que ocultas a los lectores. Una ficha oculta aún necesita un valor cuando alguien filtra la oficina central, y una celda en blanco allí parece una verificación faltante en lugar de una elección.
Dos fichas en un dominio
Dos fichas pueden compartir un host, por ejemplo, una herramienta y su página de prueba gratuita en el mismo sitio. Un puntaje pertenece a un dominio, así que ambas filas obtienen el mismo dr.
Añade una nota de texto corta como shares domain a la segunda fila. Sin ella, un editor ve dos números idénticos y asume que uno de ellos es un error de copia.
La misma regla cubre a una empresa que ejecuta varias herramientas bajo un mismo sitio. Cada herramienta puede merecer su propia página, pero su puntaje sigue siendo el puntaje del dominio en el que reside, así que dilo en la columna de notas.
Gasta llamadas de detalle donde los lectores miran
La parte superior de una categoría es donde un conteo de dominios de referencia cambia una decisión. Empieza las llamadas de 2 créditos allí y deja la cola larga en dr solo.
Revisa la división una vez al año. Las fichas suben y bajan en la página, y una fila que estaba enterrada en marzo puede ahora merecer la llamada de detalle.
Mantén la respuesta cruda una vez
Mantén el JSON crudo para cada actualización en una columna de texto o en un archivo separado. Cuando cambies lo que muestra la página, reconstruyes a partir de esa copia y evitas pagar por las mismas filas dos veces.
También te da un registro al que señalar cuando una calificación parece incorrecta. Compara la respuesta almacenada con la actual antes de cambiar cualquier puntaje a mano.
Registra también el valor ok junto a la respuesta almacenada. Una fila construida a partir de una respuesta que no era ok debe marcarse para una segunda ejecución, no confiarse como un puntaje.
Ejecuta la actualización en un orden fijo
Una actualización que toca filas en un orden aleatorio es difícil de auditar. Procesa las filas en el orden en que aparecen en la página, y escribe el primer y último dominio de la ejecución en el registro.
Si el trabajo se detiene a mitad de camino, el registro te dice dónde reanudar. Las filas que ya llevan la fecha de este mes pueden omitirse, y nada se paga dos veces.
Preguntas sobre campos
¿Debo almacenar el JSON crudo para cada ficha?
Sí, una vez por actualización. Guárdalo en una sola columna de texto o JSON, luego deriva dr y los otros campos de visualización a partir de él. Cuando cambies lo que muestras, puedes reconstruir las páginas sin llamar a la API de nuevo y pagar dos veces.
¿Qué sucede si un dominio no está en el índice?
No adivines un puntaje. Deja la celda dr vacía y no muestres ninguna insignia para esa ficha. Nuestro índice contiene 181.132.097 dominios, que es grande pero no toda la web, y un espacio en blanco es más honesto que un cero.
¿Necesito todos estos campos en la página pública?
No. Muestra la calificación y su fecha, y quizás los dominios de referencia para las fichas destacadas. Mantén el resto en la oficina central para ordenar, auditar y detectar fichas cuyos números salten entre meses.
