Lo que devuelve
Estadísticas mensuales oficiales de comercio de EE.UU. de la Oficina del Censo, por producto y país socio, en JSON limpio.
Una fila por mes, producto y país: código HS y descripción, país socio (o grupo: UE, ASEAN, USMCA, continentes, total mundial), valor en USD, valor acumulado anual, cantidad y unidad, y cambio anual sobre anual %. Las importaciones son importaciones generales; las exportaciones son exportaciones totales.
Solicitud
POST https://api.pushbuild.com/us-trade-imports-exports/run con un cuerpo JSON. Envíe su clave en el encabezado X-API-Key.
| Campo | Tipo | Descripción |
|---|---|---|
hsCodes | lista de cadenas | Códigos del Sistema Armonizado, 2, 4, 6 o 10 dígitos, p. ej. 8542 (circuitos integrados), 870380 (automóviles eléctricos). Vacío = todos los capítulos de 2 dígitos. |
flows | lista de cadenas | Por defecto: ambos. |
byCountry | boolean | Una fila por país y grupo (UE, ASEAN, continentes) en lugar del total mundial. Por defecto: false. |
countries | lista de cadenas | Nombres de socios como los escribe el Censo (CHINA, MEXICO, KOREA, SOUTH) o códigos de 4 dígitos del Censo. Anula la desglose. |
monthFrom | string | AAAA-MM. Por defecto: 25 meses atrás, para que el último año tenga cambio anual sobre anual. |
monthTo | string | AAAA-MM. Por defecto: mes anterior (el Censo publica aproximadamente 5 semanas después del final del mes). |
includeZero | boolean | Mantener los países-meses sin comercio. Por defecto: false. |
maxItems | entero | Número máximo de elementos a devolver (1-500). Predeterminado: 100. |
Ejemplo
curl -X POST https://api.pushbuild.com/us-trade-imports-exports/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"hsCodes": ["8542", "8703"], "maxItems": 20}'Respuesta
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Cada llamada devuelve hasta 500 elementos. Los registros que no pasan la validación o no se encuentran se marcan en los elementos y no se cobran.
Precios
Pague solo por los resultados devueltos: $0,40 por 1.000 filas comerciales. Sin cargo por errores o búsquedas vacías.
Úselo desde Claude, ChatGPT o Cursor
Esta API también es un servidor MCP: https://api.pushbuild.com/mcp/us-trade-imports-exports. Agréguelo a cualquier asistente que soporte servidores MCP remotos, con su clave en el encabezado X-API-Key. Mismos precios. Configuración para cada aplicación.
Díganos qué necesitan construir.
Preguntas sobre esta API, volúmenes más altos, o una fuente de datos que necesiten que aún no cubrimos.
hello@pushbuild.com