Saltar al contenido principal
POST
Retención de resultados: Pasa storage.expires_in para mantener los archivos almacenados de este mapa por más tiempo que el valor predeterminado de 7 días. Valores: 7d, 10d, 30d, 60d, 90d, 180d, 365d, o never. Consulta Almacenamiento para más detalles.

Autorizaciones

​
Authorization
string
header
requerido

Encabezado de autenticación Bearer de la forma Bearer , donde es tu token de autenticación.

Cuerpo

application/json
​
url
string<uri>
requerido

La URL del sitio web para el cual quieres los enlaces

​
storage
object

Controla cuánto tiempo se retienen los archivos almacenados de este mapa (su resultado y las páginas extraídas durante el descubrimiento). Cuando se omite, se mantienen durante 7 días. El valor en efecto se devuelve en la respuesta como storage.expires_in. Consulta la sección de Almacenamiento en la documentación de características. Un valor inválido devuelve 400 con el código invalid_storage_expires_in.

​
search_query
string

Una consulta de búsqueda opcional para ordenar los enlaces por relevancia de búsqueda.

​
top_n
number

Un número opcional para limitar solo a los n enlaces principales para una consulta de búsqueda.

​
include_subdomain
boolean

Incluir subdominios de la URL dada. true por defecto.

​
include_urls
string[]

Patrones de ruta de URL para incluir usando la sintaxis glob. Por ejemplo: /blog/** para incluir solo URLs de blogs. Solo se devolverán URLs que coincidan con estos patrones.

​
exclude_urls
string[]

Patrones de ruta de URL para excluir usando la sintaxis glob. Por ejemplo: /careers/**. Las URLs excluidas prevalecerán sobre las URLs incluidas.

​
cursor
string

OPCIONAL: Cursor de paginación de una respuesta anterior. Cuando se proporciona, devuelve el siguiente conjunto de URLs desde donde la solicitud anterior se detuvo debido al límite de tamaño de la respuesta.

Respuesta

Respuesta exitosa con URLs encontradas en la página

​
urls_count
integer
requerido

Número de URLs en la respuesta actual

​
urls
string[]
requerido

Array de URLs encontradas en la página

​
storage
object

Retención aplicada a los archivos almacenados de este mapa.

​
id
string

Identificador único para este mapa

​
cursor
string

Cursor de paginación para recuperar el siguiente conjunto de URLs limitado debido al límite de tamaño de 10MB. Si es nulo o no está presente, se han recuperado todas las URLs.

​
credits_consumed
integer | null

Número de créditos consumidos por esta solicitud. Se completa después de que la ejecución finaliza. Los créditos son la fuente de verdad para la facturación.

​
cost_usd
number | null

Costo estimado en USD para esta solicitud. Se completa después de que la ejecución finaliza. Calculado a partir de los créditos consumidos y tu tarifa de plan — 99% preciso, pero credits_consumed es el valor autoritativo.