Las antiguas URL de exportación

Antes de que existiera la API, los resultados se descargaban añadiendo ?export= y una clave a una URL de búsqueda normal. Esas URL siguen funcionando exactamente como siempre, byte a byte. No van a desaparecer.

https://publicwww.com/websites/%22angular.min.js%22/?export=csv&key=YOUR_KEY

`export=`	Devuelve
`urls`	Una URL por línea.
`csv`	`domain;rank`
`csvu`	`url;rank`
`csvsnippets`	`domain;rank;snippet`
`csvsnippetsu`	`url;rank;snippet`
`cluster`	Guarda los resultados como un clúster en lugar de descargarlos.

&delimiterColumns= y &delimiterSnippets= cambian los separadores, y https://publicwww.com/profile/api_status.xml devuelve el uso del día en XML. Envía la clave en el encabezado Authorization: Bearer <your api key>; la forma antigua ?key= sigue funcionando, pero está obsoleta, porque una clave en la dirección acaba en el historial del navegador y en los registros del servidor.

Por qué están separadas

Estas URL son la capa de compatibilidad, y mantenerlas así es lo que permite que la API sea una API moderna normal. Su salida está fijada byte a byte por una prueba que se ejecuta con cada cambio, así que un script escrito hace años sigue analizando lo mismo que siempre. No se les añade nada nuevo.

Migrar un script

Los equivalentes más cercanos:

Antes	Ahora
`?export=csv`	`format=csv`
`?export=csvu`	`format=csv&columns=url,rank`
`?export=urls`	`format=txt`
`?export=csvsnippets`	`format=csv&snippets=1`
`?export=csvsnippetsu`	`format=csv&columns=url,rank,snippets&snippets=1`
`&key=`	`Authorization: Bearer`
`&delimiterColumns=`	`delimiter=`
la consulta en la ruta de la URL	`query=`, o un cuerpo JSON
`api_status.xml`	`/v1/account`

Las columnas coinciden, así que normalmente el analizador no cambia. Lo que sí cambia vale la pena:

Una clave incorrecta es un 401 con un cuerpo JSON, no un 200 con las palabras Wrong API key donde deberían ir las filas.
Llegar demasiado rápido es un 429 inmediato con Retry-After, en lugar de mantener la conexión abierta hasta medio minuto y luego rechazarla.
Una cuota agotada es un error. En las antiguas URL te pasa discretamente a los límites del plan gratuito y devuelve menos filas, sin que nada en la respuesta lo indique.
Una respuesta recortada se marca: X-Truncated.
Paginación, para que un cliente no tenga que descargarlo todo para ver las veinte primeras filas.

Siguiente Servidor MCP