Le client Node

01

Deux lignes pour un post

Aucune clé à passer, aucun client à configurer. On l'instancie et on l'appelle.

Copier

import { Xcrap } from '@xcrapcc/sdk';

const xcrap = new Xcrap();

const tweet = await xcrap.tweet('https://x.com/jack/status/20');
console.log(tweet.text);               // just setting up my twttr
console.log(tweet.metrics.likes);      // 308067

02

Du markdown, avec son coût en tokens

Chaque méthode de lecture accepte une option markdown. La réponse revient sous forme de chaîne prête pour un prompt, et le client note combien de tokens cette chaîne coûtera probablement, pour vérifier un budget avant de le dépenser.

Copier

// Markdown, ready to drop into a prompt.
const md = await xcrap.tweet('https://x.com/jack/status/20', { markdown: true });

// How many tokens that will cost, before you spend them.
console.log(xcrap.lastMeta.markdownTokens);

03

Fils et timelines

Un fil revient déroulé et dans l'ordre, à partir du premier post et non du dernier. Une timeline pagine via les curseurs pour que vous n'ayez pas à les garder.

Copier

const thread = await xcrap.thread(
  'https://x.com/naval/status/1002103360646823936',
);

console.log(thread.count);                      // 31
for (const post of thread.tweets) console.log(post.text);

04

La recherche, avec les opérateurs de X

Passez la requête telle que vous la taperiez dans X, opérateurs compris. Une page revient avec le curseur de la suivante. La recherche a le budget le plus serré de toutes les méthodes : une requête précise vaut mieux que cinq larges.

Copier

const page = await xcrap.search('from:nasa mars', {
  feed: 'latest',          // or 'top', 'photos', 'videos'
  since: '2026-01-01',
});

for (const post of page.tweets) console.log(post.author.screen_name, post.text);

// The next page, when there is one.
if (page.next_cursor) await xcrap.search('from:nasa mars', { cursor: page.next_cursor });

05

Les erreurs sont des types, pas des codes

Chaque échec est une classe qu'on attrape par son nom. Un 404 est un post supprimé ou privé, un 429 porte le nombre de secondes avant réouverture de la fenêtre, et une panne réseau se distingue d'un refus.

Copier

import { Xcrap, XcrapNotFound, XcrapRateLimited } from '@xcrapcc/sdk';

try {
  await xcrap.tweet('https://x.com/jack/status/1');
} catch (error) {
  if (error instanceof XcrapNotFound) return null;
  if (error instanceof XcrapRateLimited) {
    // The client already knows when the window resets.
    await sleep(error.retryAfter * 1000);
  }
  throw error;
}

tweet(url, opts?)

Un post, entièrement résolu : texte, auteur, compteurs, médias, sondage et post cité éventuel.

thread(url, opts?)

Un fil entier depuis n'importe lequel de ses posts, déroulé dans l'ordre de publication.

search(query, opts?)

Les posts qui correspondent à une requête — récents, populaires, photos ou vidéos — dans une fenêtre de dates facultative.

replies(url, opts?)

Une page des réponses directes à un post, les plus aimées ou les plus récentes d'abord.

user(handle, opts?)

Un profil : bio, compteurs, date d'inscription, vérification, localisation et site web.

userTweets(handle, opts?)

Une page de posts d'un compte, avec le curseur pour la suivante.

userHistory(handle, opts?)

Jusqu'à mille posts d'un compte en un appel, du plus récent au plus ancien, dans une fenêtre de dates facultative.

followers(handle, opts?)

Une page des comptes qui suivent un compte.

following(handle, opts?)

Une page des comptes qu'un compte suit.

trends(opts?)

Ce qui est en tendance, avec le nombre de posts quand X le donne.

media(url, opts?)

Chaque fichier attaché, à tous les débits encodés par X, en liens directs.

downloadMedia(url, opts?)

Renvoie l'un de ces fichiers en flux d'octets plutôt qu'en lien.

bulk(urls, opts?)

Jusqu'à cinquante posts en une requête. Un lien mort ne fait échouer que son entrée.

Chaque paramètre, dans la référence de l'API Il existe aussi un client Python.