Rastreio USPS travou após a mudança na API? Resolvemos em minutos: uma chave, sem OAuth, 1.000 consultas grátis.

API de rastreamento USPSResponda “Cadê meu pacote?” com status ao vivo, por uma única chave de API.

Mostre o status do USPS ao vivo na sua loja, app ou central de atendimento. Uma chave de API, JSON limpo, consultas em lote e webhooks, feito para times de e-commerce nos EUA, Europa e Ásia.

Ganhe 1.000 consultas grátis Ler documentação

1.000 consultas grátis · Cadastro self-service · Preços públicos

Teste uma consulta USPS ao vivo

Restam 5 consultas ao vivo grátis hoje

USPS

CÓDIGO DE RASTREIO USPS

9589 0710 5270 2634 8701 31

Em trânsito

Your item is in transit to the next facility.

In Transit to Next Facility
— · November 11, 2026 9:18 AM
Departed USPS Regional Facility
CHICAGO, IL 60607 · November 11, 2026 3:14 AM
Arrived at USPS Regional Destination Facility
CHICAGO, IL 60607 · November 10, 2026 9:12 PM
USPS in possession of item
DALLAS, TX 75260 · November 9, 2026 7:36 PM

{
  "trackingNumber": "9589071052702634870131",
  "found": true,
  "delivered": false,
  "status": "In Transit",
  "statusDetail": "In Transit to Next Facility",
  "statusCategory": "in-transit",
  "latestUpdate": "Your item is in transit to the next facility.",
  "mailingDate": "2026-11-09",
  "product": {
    "name": "USPS Ground Advantage™",
    "features": [
      "USPS Tracking®",
      "Up to $100 insurance included"
    ]
  },
  "events": [
    {
      "status": "In Transit to Next Facility",
      "date": "November 11, 2026 9:18 AM",
      "localTime": "2026-11-11T09:18:00",
      "timeZone": "America/Chicago",
      "time": "2026-11-11T09:18:00-06:00"
    },
    {
      "status": "Departed USPS Regional Facility",
      "location": "CHICAGO, IL 60607",
      "city": "CHICAGO",
      "state": "IL",
      "zip": "60607",
      "date": "November 11, 2026 3:14 AM",
      "localTime": "2026-11-11T03:14:00",
      "timeZone": "America/Chicago",
      "time": "2026-11-11T03:14:00-06:00"
    },
    {
      "status": "Arrived at USPS Regional Destination Facility",
      "location": "CHICAGO, IL 60607",
      "city": "CHICAGO",
      "state": "IL",
      "zip": "60607",
      "date": "November 10, 2026 9:12 PM",
      "localTime": "2026-11-10T21:12:00",
      "timeZone": "America/Chicago",
      "time": "2026-11-10T21:12:00-06:00"
    },
    {
      "status": "USPS in possession of item",
      "location": "DALLAS, TX 75260",
      "city": "DALLAS",
      "state": "TX",
      "zip": "75260",
      "date": "November 9, 2026 7:36 PM",
      "localTime": "2026-11-09T19:36:00",
      "timeZone": "America/Chicago",
      "time": "2026-11-09T19:36:00-06:00"
    }
  ],
  "sourceUrl": "https://tools.usps.com/tracking/?tLabels=9589071052702634870131",
  "fetchedAt": "2026-11-11T18:00:00.000Z"
}

Exemplo200 OK · 3,4 s

Tempo médio de resposta: 3,5 s
Taxa de sucesso: >99%
Clientes e usuários: 2.000+
Por 1.000 consultas no plano de 1 mi: $5

Por que Wonca

Uma alternativa mais simples à API oficial do USPS

Desde as mudanças de plataforma de 2026, usar as APIs do USPS exige apps OAuth, pedidos de cota e revisões de acesso. A Wonca transforma tudo isso em um único endpoint.

	Integrar direto com o USPS	API USPS da Wonca
Autenticação	App OAuth 2.0 e renovação de tokens	Uma chave de API no cabeçalho
Acesso	Portal de desenvolvedor, aprovações, vínculo de contas	Cadastre-se e gere sua chave em minutos
Volume	Cotas padrão; aumentos pedidos manualmente	De 25.000 a mais de 1 mi de consultas por mês
Vários códigos de uma vez	Um código de rastreio por chamada	Consultas em lote em uma requisição
Mudanças de status	Criar e manter seu próprio polling	Webhooks enviados ao seu endpoint
Custo	Tempo de engenharia e termos de licenciamento	Planos públicos a partir de $199 por mês

A Wonca não é a API oficial do USPS. Somos um serviço independente de tratamento e organização de dados: pegamos as informações de rastreamento do USPS e entregamos no seu sistema limpas, padronizadas e prontas para usar.

Recursos

Rastreie pacotes USPS em escala: consultas individuais, em lote e webhooks

Consulta individual

Envie um código de rastreio USPS e receba status e histórico completo em JSON, em cerca de 3,5 s em média.

Consultas em lote

Verifique vários códigos em uma única operação. Ideal para sincronizações noturnas e painéis de pedidos.

Monitoramento e webhooks

Cadastre o envio uma vez. Cada novo evento do USPS chega ao seu endpoint, sem polling.

Histórico completo

Data, hora, local e descrição de cada leitura do USPS, da postagem à entrega.

Funciona com qualquer stack

Se envia HTTPS e lê JSON, funciona: Node, Python, PHP, Java, apps Shopify, ERPs e ferramentas no-code.

Cobrança previsível

Cota mensal, preço fixo e todos os recursos incluídos. Sem add-ons e sem faturas surpresa.

Casos de uso

Feito para quem depende do USPS

Marcas de e-commerce

Responda “Cadê meu pedido?” antes de virar chamado, com o status do USPS nas páginas de pedido e nos e-mails.

Vendedores cross-border

Envia da China, Europa ou América Latina para os EUA? Acompanhe a última milha do USPS em um só lugar.

3PLs e fulfillment

Leve os eventos do USPS para seu WMS ou OMS e avise seus clientes assim que um pacote parar.

Times de suporte e CX

Dê a agentes e chatbots a resposta real na hora, sem abrir o usps.com.

Como funciona

Integre o rastreamento USPS em três passos

Crie sua chave
Cadastre-se e gere uma chave de API no painel. Suas primeiras 1.000 consultas são grátis.
Envie um código de rastreio
Faça um POST do código USPS via HTTPS com a chave no cabeçalho Authorization.
Use a resposta
Mostre o status na loja, dispare e-mails ou envie eventos para seus sistemas com webhooks.

Abrir guia técnico

curl -X POST \
  https://api.wonca.com.br/wonca.labs.v1.LabsService/Track \
  -H "Authorization: Apikey YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "code": "9589071052702634870131", "carrier": "CARRIER_USPS" }'

{
  "payload": {
    "trackingNumber": "9589071052702634870131",
    "found": true,
    "delivered": false,
    "status": "In Transit",
    "statusDetail": "In Transit to Next Facility",
    "statusCategory": "in-transit",
    "latestUpdate": "Your item is in transit to the next facility.",
    "mailingDate": "2026-11-09",
    "product": {
      "name": "USPS Ground Advantage™",
      "features": [
        "USPS Tracking®",
        "Up to $100 insurance included"
      ]
    },
    "events": [
      {
        "status": "In Transit to Next Facility",
        "date": "November 11, 2026 9:18 AM",
        "localTime": "2026-11-11T09:18:00",
        "timeZone": "America/Chicago",
        "time": "2026-11-11T09:18:00-06:00"
      },
      {
        "status": "Departed USPS Regional Facility",
        "location": "CHICAGO, IL 60607",
        "city": "CHICAGO",
        "state": "IL",
        "zip": "60607",
        "date": "November 11, 2026 3:14 AM",
        "localTime": "2026-11-11T03:14:00",
        "timeZone": "America/Chicago",
        "time": "2026-11-11T03:14:00-06:00"
      },
      {
        "status": "Arrived at USPS Regional Destination Facility",
        "location": "CHICAGO, IL 60607",
        "city": "CHICAGO",
        "state": "IL",
        "zip": "60607",
        "date": "November 10, 2026 9:12 PM",
        "localTime": "2026-11-10T21:12:00",
        "timeZone": "America/Chicago",
        "time": "2026-11-10T21:12:00-06:00"
      },
      {
        "status": "USPS in possession of item",
        "location": "DALLAS, TX 75260",
        "city": "DALLAS",
        "state": "TX",
        "zip": "75260",
        "date": "November 9, 2026 7:36 PM",
        "localTime": "2026-11-09T19:36:00",
        "timeZone": "America/Chicago",
        "time": "2026-11-09T19:36:00-06:00"
      }
    ],
    "sourceUrl": "https://tools.usps.com/tracking/?tLabels=9589071052702634870131",
    "fetchedAt": "2026-11-11T18:00:00.000Z"
  },
  "carrier": "CARRIER_USPS",
  "status": "TRACKING_STATUS_FOUND"
}

Preços

Preços da API de rastreamento USPS. Todos os recursos em todos os planos.

Escolha uma cota mensal de consultas que renova a cada ciclo de cobrança. Precisa de mais de 1 milhão de consultas? Montamos o plano para você.

1.000consultas grátis

Grátis ao se cadastrar

Suas primeiras 1.000 consultas são por nossa conta.

Crie sua conta, gere uma chave e use códigos de rastreio USPS reais no seu próprio sistema. O suficiente para rastrear seus próximos 1.000 pedidos antes de pagar por um plano.

Dados reais do USPS, não um sandbox
Configuração self-service em minutos
Escolha um plano só quando estiver pronto

Ganhe 1.000 consultas grátis

Starter
Para lojas novas e pilotos
$199/mês
25.000
consultas / mês
$7,96 por 1.000 consultas
Escolher plano
Growth
Para lojas em crescimento
$399/mês
50.000
consultas / mês
$7,98 por 1.000 consultas
Escolher plano
Mais popular
Scale
Para marcas consolidadas
$749/mês
100.000
consultas / mês
$7,49 por 1.000 consultas
Economize 6% vs. Starter
Escolher plano
Business
Para marketplaces e 3PLs
$2.999/mês
500.000
consultas / mês
$6,00 por 1.000 consultas
Economize 25% vs. Starter
Escolher plano
Enterprise
Para operações de alto volume
$5.000/mês
1.000.000
consultas / mês
$5,00 por 1.000 consultas
Economize 37% vs. Starter
Escolher plano
Partner
Para grandes parceiros acima de 1 mi de consultas / mês
+1 mi
consultas / mês
Sob consulta
A partir de $0,20 por 1.000 consultas
Até 97% de desconto
vs. a tarifa Starter, conforme o seu volume
- Faixas de volume negociadas com você
- Contato dedicado e linha direta
- Configuração, faturamento e onboarding sob medida
Falar com vendas

Incluído em todos os planos:

Consultas USPS individuais e em lote
Monitoramento e webhooks
Histórico completo em JSON
HTTPS e chave de API
Documentação e suporte por e-mail

Dúvidas frequentes sobre a API de rastreamento USPS

Ficou alguma dúvida? Conte seu volume e sua stack, e indicamos o plano certo para você.

Falar com vendas

Quanto posso testar de graça?

Suas primeiras 1.000 consultas são grátis. Crie sua conta, gere uma chave e teste a API com códigos de rastreio USPS reais. Escolha um plano só quando estiver pronto para entrar em produção.

O que acontece quando as consultas grátis acabam?

Escolha um plano para continuar rastreando. As consultas grátis ficam disponíveis por tempo limitado após o cadastro, então use-as enquanto testa sua integração.

O que conta como uma consulta?

Cada requisição de rastreamento usa uma consulta da sua cota mensal. As cotas renovam a cada ciclo de cobrança.

Qual a velocidade da API?

O tempo médio de resposta é de 3,5 segundos para uma consulta ao vivo no USPS, com taxa de sucesso acima de 99%.

Esta é a API oficial do USPS?

Não. A Wonca é um serviço independente de tratamento e organização de dados, sem vínculo com o USPS. Processamos as informações de rastreamento do USPS e entregamos em JSON limpo e padronizado, para que seu time não precise lidar com a integração oficial.

Preciso da minha própria conta de desenvolvedor no USPS?

Não. Você só precisa de uma chave de API da Wonca; nós cuidamos da conexão com o USPS.

Posso rastrear vários códigos de uma vez?

Sim. Use consultas em lote para vários códigos em uma operação, ou monitoramento com webhooks para receber atualizações automaticamente.

Funciona com a minha plataforma?

Sim, desde que seu sistema envie requisições HTTPS e leia JSON: qualquer linguagem, ERP, plataforma de e-commerce ou ferramenta de automação.

E se eu precisar de mais de 1 milhão de consultas?

O plano Enterprise inclui 1 milhão de consultas por $5.000 por mês ($5 por 1.000). Acima disso, o plano Partner oferece a grandes parceiros preço personalizado a partir de $0,20 por 1.000 (até 97% de desconto), com contato dedicado.

Vocês atendem outras transportadoras?

Sim. Além do USPS, também rastreamos Correios (Brasil), CAINIAO e J&T Express (Brasil).

Leve o rastreamento USPS ao vivo para seus clientes hoje.

Comece com 1.000 consultas grátis e entre em produção a partir de $199 por mês, ou fale com a gente sobre volume.

Ganhe 1.000 consultas grátis Falar com vendas