Descarga la exportación semanal de tarifas de mercado

Con un plan Enterprise que tenga la exportación activada, descarga por la API un CSV semanal con las tarifas de mercado de las rutas.

Broker
Updated
October 2, 2026

En 4 pasos

  1. Confirma que tu plan la incluye
  2. Obtén una clave de API
  3. Descarga la semana más reciente
  4. Descarga semanas anteriores

Con un plan Enterprise que tenga la exportación activada, puedes descargar un archivo CSV semanal con las tarifas de mercado de las rutas, en lugar de consultarlas una por una. Obtienes los archivos por la API con la clave de API de tu empresa.

Paso 1: Confirma que tu plan la incluye

La exportación requiere un plan Enterprise con la exportación activada para tu organización. Pregunta a tu gerente de éxito, o a sales@cargado.com, si el tuyo la incluye. Si la exportación está desactivada en la configuración de tu organización, la API responde (en inglés) Market rate export requires an Enterprise plan. Contact sales@cargado.com to upgrade. Otras configuraciones devuelven errores distintos.

Paso 2: Obtén una clave de API

Pide al equipo de Cargado una clave con el permiso de tarifas de mercado; el equipo de Cargado la crea. Consulta Obtén una clave de API para tu integración. Envía la clave en el encabezado api-key en cada solicitud a https://api.cargado.com.

Paso 3: Descarga la semana más reciente

Llama a GET /rates/history-exports sin fechas. La respuesta trae el archivo de la semana de mercado completa más reciente: urls tiene una entrada con el link de descarga, el día en que terminó la semana y cuándo vence el link. Si el archivo de esa semana todavía no está disponible, urls regresa vacío; vuelve a intentar más tarde. Cada link funciona durante una hora después de generarse.

Arriba: un editor de código, oscurecido, con la llamada GET https://api.cargado.com/rates/history-exports y su respuesta resaltadas y marcadas como Paso 3. Abajo, de cerca: la llamada sin fechas y una respuesta con una sola entrada en urls. La marca 1 señala la línea GET. La marca 2 señala url, un link firmado al CSV del 2026-09-28. La marca 3 señala expiresAt.

Ejemplo: el host, la firma, las fechas y la clave son ficticios.

  1. GET /rates/history-exports sin fechas: la semana completa más reciente.
  2. url: el link de descarga del CSV de esa semana.
  3. expiresAt: cuándo deja de funcionar el link, una hora después de generarse.

Cada semana de mercado va de martes a lunes, y hay un archivo por semana; day es el lunes en que terminó la semana. Cargado genera el archivo con una tarea programada el martes temprano (06:00 UTC, en la madrugada del martes, hora del centro de EE. UU.). Si automatizas la descarga, prográmala para más tarde el martes y vuelve a intentar cuando urls regrese vacío.

Paso 4: Descarga semanas anteriores

Para obtener archivos anteriores, agrega snapshotStart y snapshotEnd como fechas (AAAA-MM-DD). Manda los dos o ninguno; el inicio no puede ser después del fin, y el fin no puede ser una fecha futura. Recibes una entrada por cada semana de mercado que se traslapa con el rango, de la más reciente a la más antigua, hasta 20 por llamada. Las semanas sin archivo se omiten, y como cuenta la semana completa de martes a lunes, el day de una semana puede quedar un poco fuera de las fechas que enviaste.

Arriba: el mismo editor de código, oscurecido, con la llamada con fechas y su respuesta resaltadas y marcadas como Paso 4. Abajo, de cerca: GET /rates/history-exports con snapshotStart 2026-08-31 y snapshotEnd 2026-09-28, y una lista urls con cinco entradas, una por semana de mercado, de la más reciente a la más antigua, desde la semana que terminó el 2026-09-28 hasta la que terminó el 2026-08-31. La marca 1 señala las dos fechas. La marca 2 señala la lista de archivos semanales.

Ejemplo: las fechas son ilustrativas; cada day es un lunes.

  1. snapshotStart y snapshotEnd: los dos o ninguno.
  2. Una entrada por semana de mercado que se traslapa con el rango, de la más reciente a la más antigua, hasta 20.

Para tomar en cuenta

  • Qué contiene el archivo: cada renglón es una ruta en una semana, para las rutas donde Cargado tiene historial de tarifas esa semana (las rutas sin historial no tienen renglón):
    • start_date y end_date de la semana.
    • Bajo, Medio y Alto como total (p25_amount, p50_amount, p75_amount) y por milla (p25_cost_per_mile, p50_cost_per_mile, p75_cost_per_mile), en USD. Las columnas por milla pueden venir vacías.
    • margin_of_error, relative_margin_of_error y confidence_score, cuando Cargado los tiene.
    • Origen y destino: ID, código, nombre, país y tipo del mercado de cada uno (si es un mercado extendido).
    • us_mx_border_crossing e is_suggested_border_crossing, vacíos en las rutas sin cruce.
    • trailer_category.
  • Solo en USD: la exportación solo viene en USD. Para pesos o dólares canadienses, usa una consulta en la plataforma o en la API.
  • Los links vencen: cada link de la respuesta funciona durante una hora. Descarga pronto, o vuelve a llamar para recibir un link nuevo.
  • Relacionado: Consulta tarifas de mercado con la API y Cómo leer una tarifa de mercado.

Still stuck?

Email us and a person on our team will answer. Send the posting link or a screenshot if you have one.