Preguntas frecuentes
Si algo no está respondido aquí, la referencia de la API es más detallada.
¿Qué es XCrap?
Un servicio gratuito que lee posts, hilos y perfiles públicos de X y los devuelve como Markdown, JSON, YAML, CSV o HTML. Existe para que agentes, bots y proyectos pequeños puedan leer X sin API key.
¿De verdad es gratis?
Sí. Sin cuenta, sin clave, sin tarjeta, sin prueba. Se paga con donaciones, y los gastos son un dominio y un servidor pequeño.
¿Necesito una API key?
No. No hay clave que generar ni cabecera que enviar. Los límites se aplican por dirección IP y por endpoint.
¿Cuáles son los límites de peticiones?
Por IP y por endpoint: 45 peticiones por minuto para posts sueltos y perfiles, 15 por minuto para hilos, timelines, respuestas y listas de seguidores, 20 por minuto para media, 4 exportaciones de historial y 6 peticiones bulk cada cinco minutos, y 10 búsquedas cada quince minutos. Cada respuesta indica cómo vas en las cabeceras x-ratelimit. ¿Necesitas más? Mira el plan para empresas.
¿Puede leer cuentas privadas o protegidas?
No, y nunca lo hará. Las cuentas protegidas devuelven el mismo 404 que le darían a cualquiera, y los mensajes directos quedan totalmente fuera de alcance. XCrap solo lee cuentas públicas: sus posts, perfiles, respuestas y listas de seguidores.
¿Puede leer posts borrados?
No. Si un post ya no está en X, aquí tampoco. La caché de cinco días puede conservar un momento algo borrado hace un instante, y esa copia se tira al expirar.
¿Cómo obtengo un hilo entero?
Usa /v1/thread con el enlace de cualquier post del hilo, incluido el primero. X solo indica el padre de un post, así que cosemos la timeline del autor por id de conversación para recorrer el hilo hacia adelante.
¿Puedo descargar el video o las imágenes?
Sí. /v1/media lista cada archivo adjunto con un enlace de descarga, en cada bitrate que X codificó. Los archivos pasan de largo y nunca se escriben en nuestro disco.
¿Qué formatos puedo obtener?
JSON, Markdown, YAML, CSV y una tarjeta HTML independiente. Añade ?format= a cualquier petición, o envía una cabecera Accept.
¿Cómo lo uso desde un agente de IA?
Tres formas. Añade el servidor MCP a la configuración de tu cliente, descarga el archivo de skill y pégalo en tu prompt, o apunta tu framework a la spec OpenAPI.
¿Qué es la cabecera x-markdown-tokens?
Una estimación de cuántos tokens costará una respuesta Markdown, enviada con cada respuesta Markdown. Permite a un agente decidir si un hilo cabe en su contexto antes de leer el cuerpo.
¿Hay búsqueda de texto completo?
Sí: /v1/search acepta cualquier consulta que entienda la búsqueda de X, operadores incluidos (from:, "frase exacta", since:…), y devuelve los posts más recientes o los más destacados, o solo los que tienen fotos o vídeos. Es el endpoint con el límite de peticiones más estricto.
¿Cuánto tiempo se guardan mis peticiones?
Los logs de peticiones guardan la ruta, la marca de tiempo, la IP y las cabeceras para poder detectar abusos y depurar fallos. El contenido de los posts se cachea cinco días y luego se borra. Somos una tubería, no un archivo.
¿Esto es legal?
Leer páginas web públicas no es acceso no autorizado, algo que los tribunales de EE. UU. confirmaron en hiQ v. LinkedIn. Sí incumple los términos de servicio de X, lo cual es un asunto contractual entre X y nosotros, no penal. Eres responsable de lo que hagas con los datos que recibes.
Estoy en X y no quiero que se me pueda leer por aquí.
Escribe a [email protected] desde una dirección vinculable a la cuenta y el handle pasa a una lista de bloqueo que se consulta antes de ejecutar cualquier petición. Sin discusión, sin formulario.
¿Por qué no usar la API oficial?
Úsala si puedes. Cuesta $200 al mes en el nivel de entrada y $42,000 en el más alto, y el nivel gratuito no puede leer posts en absoluto. XCrap existe para todos los que están por debajo de esa línea.
¿Qué pasa cuando X cambia algo?
Detrás de cada endpoint hay cuatro fuentes y fallan de forma independiente. Cuando nuestro propio cliente se rompe, las peticiones caen a la siguiente y siguen respondiendo mientras lo arreglamos.
¿Puedo alojarlo yo mismo?
No. XCrap es de código cerrado y no hay ninguna distribución que puedas ejecutar. Si necesitas capacidad garantizada para algo importante, el plan para empresas ofrece capacidad dedicada y límites más altos: escribe a [email protected]. La API gratuita sigue siendo gratis mientras las donaciones cubran el servidor.
¿Puedo usarlo comercialmente?
Sí. La API gratuita no tiene clave de licencia ni niveles de uso. Respeta los límites de peticiones y recuerda que eres responsable de cumplir con los términos de X y con la ley de protección de datos donde operes. Si tu producto necesita más capacidad, el plan para empresas está hecho para eso.
¿Cómo puedo ayudar?
Dona si puedes, porque los servidores son el único gasto real. Reporta lo que esté roto. Cuéntale a otra gente que construye agentes que esto existe.
¿Aparecéis en algún sitio?
Aura++ incluye XCrap en su directorio, y su insignia está debajo. Si llevas un directorio y quieres añadirlo, escribe a [email protected] y tu insignia se pondrá junto a esa.
¿Sigues atascado?
La referencia de la API documenta cada parámetro y cada código de error.