---
title: "The Seller API: API pública de costos de WhatsApp"
description: "API pública y gratuita de The Seller para simular el costo de mensajes en la API oficial de WhatsApp en Brasil, con especificación OpenAPI, ejemplos y formato de errores."
url: https://www.theseller.com.br/es/developers
lang: es
---

DESARROLLADORES

# The Seller API

API pública, gratuita y sin autenticación para simular cuánto cuesta enviar mensajes por la API oficial de WhatsApp en Brasil. Usa la misma tabla que nuestra calculadora: tarifa de Meta por categoría, tramos de volumen y la tarifa de The Seller por mensaje.

[Especificación OpenAPI 3.1](https://www.theseller.com.br/openapi.json) [llms.txt para agentes de IA](https://www.theseller.com.br/llms.txt)

## Endpoints

URL base: `https://www.theseller.com.br`

Autenticación: ninguna. Respuestas en JSON, con CORS habilitado.

### Simular costo de mensajes

GET /api/v1/whatsapp-pricing/simulate

Calcula el costo de Meta (con tramos de volumen), la tarifa de The Seller y el costo total y medio por mensaje, en reales.

#### Parámetros

- `quantity`: obligatorio. Número de mensajes (1 a 1.000.000.000).
- `category`: marketing (predeterminado), utility o authentication.
- `currency`: moneda de la cuenta Meta: BRL (predeterminado) o USD.
- `exchangeRate`: reales por dólar, usado cuando currency=USD. Predeterminado 5,4.

```
curl "https://www.theseller.com.br/api/v1/whatsapp-pricing/simulate?quantity=10000&category=marketing"
```

### Tabla de tarifas

GET /api/v1/whatsapp-pricing/rates

Devuelve las tarifas de lista y los tramos de volumen de Meta para Brasil, la tarifa de The Seller y las fuentes oficiales.

```
curl "https://www.theseller.com.br/api/v1/whatsapp-pricing/rates"
```

## Ejemplo de respuesta

```
{
  "input": {
    "quantity": 10000,
    "category": "marketing",
    "currency": "BRL",
    "exchangeRate": 5.4,
    "market": "brazil"
  },
  "meta": {
    "currency": "BRL",
    "cost": 3217,
    "costBRL": 3217,
    "effectiveRate": 0.3217,
    "tiers": [
      {
        "quantity": 10000,
        "rate": 0.3217,
        "cost": 3217,
        "from": 1,
        "to": 10000
      }
    ]
  },
  "theSeller": {
    "ratePerMessageBRL": 0.1,
    "costBRL": 1000
  },
  "totalCostBRL": 4217,
  "averageCostPerMessageBRL": 0.4217,
  "rateCardUpdatedAt": "setembro de 2026",
  "notes": [
    "Estimate only. Meta bills its fee directly in the account currency; the final amount depends on Meta's rate card on the billing date.",
    "Service (user-initiated) conversations are not included."
  ]
}
```

## Errores

Los errores siempre vuelven en JSON, con un código estable, un mensaje, una pista para corregir la solicitud y el enlace a esta documentación. Códigos: invalid_parameter y missing_parameter (400), not_found (404) y method_not_allowed (405).

```
{
  "error": {
    "code": "invalid_parameter",
    "message": "category must be one of: marketing, utility, authentication.",
    "hint": "Use the Meta template category of the message.",
    "docs": "https://www.theseller.com.br/developers",
    "parameter": "category"
  }
}
```

## API de la plataforma

La API para integrar tus sistemas con la plataforma The Seller es parte del plan Prime. Para acceso y documentación, habla con nuestro equipo.
[Hablar con el equipo](https://www.theseller.com.br/es/contacto)

Operación comercial en WhatsApp. API oficial, agentes de IA y automatizaciones trabajando juntos para que tu empresa venda todos los días.

### Producto

- [Funcionalidades](https://www.theseller.com.br/es/funcionalidades)
- [Precios](https://www.theseller.com.br/es/precios)
- [Calculadora](https://www.theseller.com.br/es/calculadora)
- [Integraciones](https://www.theseller.com.br/es/integraciones)
- [Segmentos](https://www.theseller.com.br/es/segmentos)
- [API para desarrolladores](https://www.theseller.com.br/es/developers)

### Empresa

- [Nosotros](https://www.theseller.com.br/es/nosotros)
- [Contacto](https://www.theseller.com.br/es/contacto)
- [Casos](https://www.theseller.com.br/es/casos)
- [Política de Privacidad](https://www.theseller.com.br/es/politica-de-privacidad)
- [Términos de uso](https://www.theseller.com.br/termos-de-uso)

### Contacto

- [(34) 8440-0300](tel:+553484400300)
- [contato@theseller.com.br](mailto:contato@theseller.com.br)
- Uberlândia, MG, Brasil

© 2026 The Seller. Todos los derechos reservados. · THE SELLER LTDA · CNPJ 61.664.493/0001-59

Meta Business Partner · API oficial de WhatsApp