fetch_url
Obtenga y analice páginas web con manejo automático de redirecciones, control de tiempo de espera y encabezados personalizados. Ideal para recuperar contenido HTML de cualquier URL de acceso público.
Casos de uso
Recuperación de contenido de páginas
Obtenga contenido HTML de cualquier página web para procesarlo o analizarlo después
Obtención de datos de API
Realice solicitudes GET a APIs REST y recupere respuestas JSON
Comprobaciones de estado
Monitoree la disponibilidad de sitios web y los tiempos de respuesta
Descargas simples
Descargue recursos estáticos, documentos o contenido de páginas
Endpoint
/api/v1/tools/fetch_urlParameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
url | string | Required | - | La URL a obtener (debe incluir el protocolo: http:// o https://) Example: https://example.com |
headers | object | Optional | - | Encabezados HTTP personalizados a incluir en la solicitud Example: {"Accept": "text/html", "User-Agent": "MyBot/1.0"} |
timeout | number | Optional | 10000 | Tiempo de espera de la solicitud en milisegundos (1000-30000) Example: 15000 |
follow_redirects | boolean | Optional | true | Si se deben seguir las redirecciones HTTP automáticamente Example: true |
user_agent | string | Optional | - | Encabezado User-Agent personalizado (reemplaza el predeterminado) Example: Mozilla/5.0 (compatible; CrawlBot/1.0) |
Ejemplos de solicitud
cURL
TypeScript
Python
Ejemplo de respuesta
{ "success": true, "data": { "url": "https://example.com", "status": 200, "status_text": "OK", "headers": { "content-type": "text/html; charset=UTF-8", "content-length": "1256", "server": "nginx" }, "content": "Example Domain ......", "content_length": 1256, "content_type": "text/html; charset=UTF-8", "redirected": false, "final_url": "https://example.com" }, "credits_used": 1, "credits_remaining": 999, "processing_time": 245}data.urlLa URL original que se solicitódata.statusCódigo de estado HTTP de la respuestadata.contentEl contenido HTML completo de la páginadata.content_lengthTamaño del contenido en bytesdata.final_urlURL final después de seguir las redireccionescredits_usedCredits descontados por esta solicitud (1 por cada obtención)credits_remainingSu saldo restante de creditsManejo de errores
URL no válida (400 Bad Request)
El formato de la URL no es válido. Asegúrese de que incluya el protocolo (http:// o https://)
Error de tiempo de espera (500 Internal Server Error)
La solicitud tardó más que el tiempo de espera especificado. Intente aumentar el parámetro timeout.
Credits insuficientes (402 Payment Required)
Su cuenta no tiene suficientes credits. Compre más credits o mejore su plan.
Límite de tasa excedido (429 Too Many Requests)
Ha excedido el límite de tasa de su plan. Espere un momento o mejore su plan para obtener límites más altos.
Costo en credits
Plan Free: 1,000 credits de prueba por única vez = 1,000 solicitudes
Plan Hobby: 5,000 credits/mes = 5,000 solicitudes ($19/mo)
Plan Professional: 50,000 credits/mes = 50,000 solicitudes ($99/mo)
Plan Business: 250,000 credits/mes = 250,000 solicitudes ($399/mo)