Xatools by 3men2

Herramientas para Xat

@Marv (1997)
xat.com ↗

API pública de Xatools para xat

API pública de Xatools: powers, precios, peones, stickers y contador de xat

JSON gratuito y sin registro para tu web, bot o app. Los datos se leen directamente de xat.com cada 5 minutos (se detecta cada power nuevo automáticamente) y se completan con los precios de fair-trade. CORS abierto, respuestas cacheadas 5 minutos.

Estado Comprobando…
URL basehttps://api.xatools.net/v1
LímitesUso justo: 120 peticiones/min por IP. Cachea las respuestas (cambian cada 5 min).
AtribuciónEnlace a xatools.net · datos: xat.com · precios: fair-trade.

Probar en vivo

Se ejecuta en tu navegador contra la API real
api.xatools.net/v1/
Pulsa «Consultar» o elige un ejemplo.

Endpoints

Todos responden JSON con code: 200 y updated (unix) de la última actualización. Añade ?pretty para verlo formateado. Los nombres de power no distinguen mayúsculas.

GET/v1/latestÚltimo power con ficha completa, contador del próximo y los 14 más recientes

Campos: latest (ficha completa, ver /v1/power), countdown (ver /v1/countdown), recent[] (resumen), stickers[] (últimos powers con stickers).

GET/v1/countdownContador del próximo power (solo anuncios reales)

status: announced (anuncio oficial de xat), manual (fijado por el equipo de Xatools), o none (sin anuncio: no se estima ni se predice nada) o released (lanzado en las últimas 12 h). time (unix), iso, seconds_left, power (id y nombre si xat lo indica), max_per_user, amount, last (último power), median_interval_days. Announce.php se lee cada 60 s (relay propio), así que el contador aparece en cuanto xat lo anuncia; el power nuevo se detecta en ≤2 min y el contador se reinicia solo.

GET/v1/releasesHistorial de lanzamientos

announces[] (anuncios de xat registrados: seen, time, power_id, name, max_per_user, amount) y detected[] (cuándo apareció cada power en la tienda). El historial de un power concreto también va en /v1/power/{name} → history[].

GET/v1/powersCatálogo completo (resumen por power)

Parámetros: q (texto en nombre, descripción o smilies), status (unlimited, limited, epic, collection, subscription), category (group, stickers, ace, hug, game, epic, allpowers, new… o el nombre de una sección de la tienda), type (smiley, function, stickers, supers…), limit, offset, full=1 (incluye smilies, peones, stickers, hugs…).

GET/v1/power/{nombre|id}Ficha completa de un power

id, name, status, type, category, short, long, store {xats|days, text}, trade {min, max, min_days, max_days} (fair-trade), released, released_int, categories[], smilies[], pawns[] {name, hat}, stickers[], stickers_total, hugs[], backgrounds[], aces[], effects[], frames[], collection {required[], pawns[], smilies[]}, images {icon, strip80, smiley}.

GET/v1/collections · /v1/collection/{nombre}Colecciones (super powers)

Cada colección: id, name, required[] {id, name} (powers necesarios según xat), pawns[] (peones que desbloquea), smilies[].

GET/v1/pawnsPeones activos de xat

active[] {key, power_id, name, hat} directamente de xat (código listo para usar, p. ej. (hat#hJa)), time (vigencia) y fair_trade[] como referencia.

GET/v1/stickers · /v1/stickers/{power}Powers con stickers y su lista
GET/v1/pricesPrecio de tienda y rango de trade de todos los powers

Precio de tienda según xat.com y rango de trade según fair-trade, actualizado cada 6 h.

GET/v1/hugs · /v1/aces · /v1/effects · /v1/backgrounds · /v1/free · /v1/typesHugs, aces, efectos y frames, fondos por power, smilies gratis, secciones de la tienda
GET/v1/smiley/{código} · /v1/search?q=A qué power pertenece un smiley · búsqueda rápida
GET/v1/promoted?lang=es · /v1/announce · /v1/statusChats promocionados por idioma · anuncios de xat · estado del servicio
GET/v1/user/{id|nick} · /v1/user/{id|nick}/online · /v1/user/{id|nick}/powersID ↔ nombre · ¿está en línea? · powers, dobles y faltantes de un usuario

Datos en directo desde xat.com a través del bot de Xatools. El estado se guarda 1 minuto y los powers 5 minutos; xat solo revela los powers de un usuario cuando el bot lo ve en un chat (o responde a una localización), así que puede devolver 404 hasta entonces. También /v1/room/{chat} (info de una sala) y /v1/bot (estado del bot). Interfaz web: /usuario/.

Ejemplo de uso

// JavaScript (navegador o Node 18+)
const r = await fetch('https://api.xatools.net/v1/latest');
const { latest, countdown } = await r.json();
console.log(latest.name, latest.store.text, latest.smilies);
if (countdown.time) console.log('Próximo power:', new Date(countdown.time * 1000));

// PHP
$j = json_decode(file_get_contents('https://api.xatools.net/v1/power/purple'), true);
echo $j['power']['trade']['min'] . ' - ' . $j['power']['trade']['max'] . ' xats';

// Python
import requests
p = requests.get('https://api.xatools.net/v1/powers', params={'status': 'limited', 'limit': 10}).json()
print([x['name'] for x in p['powers']])

Xatools no está afiliado a xat.com. Los datos provienen de fuentes públicas de xat.com; precios: fair-trade. Si tu proyecto hace un uso intensivo, cachea las respuestas al menos 5 minutos.

Datos de xat listos para tu web, bot de Discord o app: powers con descripción, precio y estado, colecciones con sus requeridos, peones activos con su código, stickers, hugs, aces, chats promocionados y un contador del próximo power que se reinicia solo cuando xat publica uno nuevo. Se lee directamente de xat.com cada 5 minutos y se completa con los precios de fair-trade.

Preguntas frecuentes

¿Necesito clave o registro?+

No. La API es pública y abierta con CORS. Solo pedimos un uso razonable (cachea las respuestas al menos 5 minutos) y un enlace a xatools.net si muestras los datos.

¿De dónde salen los datos?+

De los archivos públicos de xat.com (catálogo de powers, tienda, peones y anuncios) leídos cada 5 minutos, y de fair-trade para los precios de trade.

¿Cómo funciona el contador del próximo power?+

Solo se muestra cuando xat publica oficialmente una fecha (o cuando el equipo de Xatools la fija a partir de un anuncio). Nunca se estima ni se predice: si no hay anuncio, el estado es «sin contador». En cuanto aparece un power nuevo en xat.com se detecta en menos de 5 minutos.