Documentos
Ctrl+K Buscar Alt+[Alt+] Guías
Obtener clave API

Guías

Créditos y facturación

Cada solicitud de clave API que se procesa con éxito consume créditos de API mensuales. En esta guía se explica en qué consiste el límite, cuándo se restablece, qué se considera una solicitud facturable y cómo supervisar el uso.

El

Configuración Valor Notas
Límite de crédito mensual 20 000 por usuario Valor predeterminado del producto; se restablece cada mes natural (UTC).
Coste por solicitud 1 crédito Cada solicitud con contador completada con éxito = 1 crédito.
Restablecer la cadencia Mes natural El contador se reinicia automáticamente al comienzo del mes siguiente.
Destinado a La cuenta vinculada a la clave API (consulte su uso en la página de la API dentro de la aplicación). Se utiliza el mismo conjunto de claves para esa cuenta.

Cuando se alcanza el límite, cada solicitud posterior devuelve:

HTTP/1.1 429 Too Many Requests
Content-Type: application/json

{
  "success": false,
  "error": "Monthly credit limit reached (20000). Resets next month.",
  "credits": { "used": 20000, "limit": 20000, "remaining": 0 }
}

El contador se reinicia automáticamente al comienzo del siguiente mes natural; no es necesario hacer nada.

Lo que cuenta (y lo que no)

Cada llamada programática con tarificación por uso intenta cobrar 1 crédito antes de que se ejecute la tarea principal. Si el servidor detecta un error no detectado tras el cobro, se devuelve el crédito; no se te cobrará por ese fallo.

Las rutas con tarificación por distancia recorrida incluyen:

  • Todo /api/v1/tiktok-shop/* parámetros.
  • GET /api/v1/adlibrary.
  • POST /api/v1/magic-ai.
  • GET /api/v1/store-tracker, POST /api/v1/store-explorer.
  • GET /api/v1/marcas.

Sin versión /api/adlibrary, /api/store-tracker, y /api/explorador-de-tiendas siguen aceptándose como alias (mismo contador). /api/magic-ai y /api/marcas son panel de control rutas — para el uso de una clave API /api/v1/magic-ai y /api/v1/marcas.

Antes de que se aplique ningún cargo, estas respuestas se devuelven sin coste alguno (y no cuentan para el límite de la tarifa por minuto):

  • 401 Acceso no autorizado — clave ausente o no válida.
  • 403 — El acceso a la API no está habilitado para esta cuenta.

Respuestas correctas y la mayoría 429 filas son registrados y contabilizados para el 60 por minuto ventana (véase Límites de velocidad).

Panel de control frente a

Es posible que la aplicación del navegador aplique un sistema de medición diferente al de las llamadas directas a la API. En el caso de las integraciones, se debe considerar 1 crédito por cada solicitud medida que se haya completado con éxito, a menos que tu contrato indique lo contrario.

Seguimiento del uso del crédito

curl -sS \
  -H "X-API-Key: $WH_API_KEY" \
  "{origin}/api/v1/tiktok-shop/credits"

Devuelve lo mismo { utilizado, límite, restante } la forma que tiene el cuerpo 429. Cuesta 1 crédito (sí, consultar el saldo consume un crédito; guárdalo en caché en el lado del cliente).

Panel de

Mientras estás conectado:

  • GET /api — Widget de créditos visuales + gráfico de uso de los últimos 14 días + registro de solicitudes recientes.
  • GET /api/usage — JSON: { usage: [{ day, requests }, …], credits: { used, limit, remaining } }.
  • GET /api/logs?page=N — Registro de solicitudes paginado (50 entradas por página) con códigos de estado y direcciones IP.

Estas tres son cookies de sesión. No consumen créditos.

MCP y

Protocolo de contexto de modelos utiliza el el mismo fondo común mensual (20 000). Cada MCP completado con éxito herramientas/llamada cargos 1 crédito — incluyendo herramientas como ver créditos. inicializar, herramientas/lista, ping, etc. hacen no cobrar.

El tráfico de la herramienta MCP tiene su propio límite de ráfagas por minuto (véase MCP); no sustituye a la sección sobre la limitación de solicitudes REST de esta guía para /api/*.

de la capacidad#

Llamadas por minuto Llamadas al día (constantemente) Días para agotar los 20 000
1 / min 1,440 ~14
10 por minuto 14,400 ~1.4
30 / min 43,200 ~0.5
60 / min (límite máximo de frecuencia) 86,400 ~0.23

Para cargas de trabajo continuas de ETL o de rellenado de datos, el diseño debe basarse en la capacidad diaria, no en la capacidad por minuto. El límite de velocidad restringe los picos de actividad (60 por minuto); la cuota de créditos limita el volumen (20 000 al mes).

Estrategias para sacar el máximo partido a tus

  • Lote con PUBLICAR JSON. Los conjuntos de filtros amplios en una sola solicitud son más eficaces que muchos filtros específicos.
  • Almacenar en caché las consultas. Jerarquías de categorías, listas de países, configuraciones de filtro predeterminadas: recuperarlas como máximo una vez al día.
  • Uso recuento antes explorar cuando solo necesitas un número.
  • No realices encuestas créditos de forma agresiva — Cada llamada cuesta 1 crédito. Realiza un seguimiento del uso en el lado del cliente mediante tu propio contador de respuestas y vuelve a sincronizar desde /api/v1/tiktok-shop/credits una vez cada hora.

Restablecer

El contador de uso se reinicia al comienzo de cada mes natural (UTC) en el servidor. La primera solicitud contabilizada de un nuevo mes inicia automáticamente un nuevo contador.

¿Qué pasa con los cambios en el plan?

  • Actualización a mitad de mes: tu contador de créditos actual sigue sumando; el límite se mantiene en 20 000 (la cuota es por usuario, no por nivel).
  • Pérdida de acceso a la API: las llamadas con tarificación por uso devuelven el código de error 403 hasta que se restablezca el acceso; por lo general, los contadores de uso anteriores se mantienen si se vuelve a habilitar el acceso dentro del mismo periodo; compruébalo en el panel de control.
  • Si necesitas un volumen mayor: ponte en contacto con el servicio de asistencia para acordar un límite personalizado.