logo
FR

Recherche Twitter par mot-clé

Indiquez un mot-clé de recherche Twitter et un nombre attendu pour obtenir les identifiants de publications publiques correspondantes, leurs dates de publication et les métadonnées de collecte.

Traduit · fr-FRVoir le texte original

Aperçu

Pour étudier la façon dont un sujet apparaît dans la recherche Twitter, il faut d’abord un ensemble fiable d’identifiants de publications et de dates de publication. Cette application transforme un mot-clé de recherche en une collection structurée d’éléments correspondants, en conservant le mot-clé et le contexte de collecte à côté de chaque identifiant afin que le jeu de données reste compréhensible après export ou jointure.

Le résultat sert d’index de découverte : il montre quelles publications publiques étaient associées à une marque, un produit, un sujet ou une campagne au moment de la collecte. Il convient particulièrement à la constitution d’ensembles de suivi reproductibles, à la comparaison des populations de contenus trouvées pour différents termes, et à la préparation d’identifiants pour une analyse ultérieure sans copier manuellement les éléments depuis les pages de recherche.

Notes sur les données

Chaque enregistrement représente une publication Twitter associée au mot-clé soumis, ou un indicateur sans données pour cette recherche. Les ID de contenu sont dédupliqués dans le jeu renvoyé. Mot-clé correspondant, Élément source et ID métier conservent le contexte de collecte et peuvent se répéter sur de nombreux enregistrements de la même recherche. Date de publication, Heure de collecte et Heure de nettoyage sont renvoyées sans fuseau horaire; elles ne doivent pas être lues comme des horodatages absolus inter-régions sans contexte supplémentaire. Le type de mot-clé décrit la nature de l’élément de recherche attaché à l’enregistrement.

La collection contient des identifiants, des horodatages et des métadonnées de collecte, pas le texte des publications, les médias, les totaux d’engagement, les commentaires ni un profil d’auteur complet. Un indicateur sans données distingue les métadonnées de recherche sans contenu correspondant des enregistrements correspondants ordinaires. Les contenus Twitter privés, supprimés ou non recherchables ne sont pas couverts.

À quoi ressemble un résultat

Chaque ligne est une publication Twitter correspondante ou un indicateur sans données associé au mot-clé de recherche.

ID de contenuMot-clé correspondantDate de publicationHeure de collecteIndicateur sans données
2092504987695714392shokz2026-03-17T15:43:442026-08-26T18:50:22Non
2092527502547927469shokz2025-12-19T17:41:092026-08-26T18:50:22Non

Le type de mot-clé, l’ID d’enregistrement collecté, l’ID métier, l’élément source et l’heure de nettoyage sont également disponibles lorsqu’ils sont fournis avec l’enregistrement.

Cas d’usage

  • Pour la découverte de sujets, regrouper les lignes par Mot-clé correspondant et compter les valeurs distinctes d’ID de contenu afin de comparer la population de publications recherchables associée à chaque terme.
  • Pour le suivi, répéter une collecte par mot-clé et comparer les ensembles d’ID de contenu, en utilisant Date de publication et Heure de collecte comme contexte fourni par la source pour les éléments nouvellement observés.
  • Pour vérifier la provenance, comparer Mot-clé correspondant, Élément source et ID métier avant de combiner des jeux de données.
  • Pour le contrôle qualité, filtrer sur Indicateur sans données afin de séparer les métadonnées de recherche vide des enregistrements correspondants utilisables.

Périmètre et limites

Un mot-clé de recherche Twitter par tâche, avec un nombre attendu de 1 à 2000; les résultats arrivent par lots complets de 20 et peuvent être arrondis à la hausse; la protection d’extraction couvre 100 pages ou 2000 enregistrements; la couverture se limite aux listes publiques de recherche Twitter par mot-clé.

  • Adapté pour
  • Lorsque vous avez besoin des identifiants de publications Twitter publiques et des dates de publication renvoyés par une recherche par mot-clé pour une marque, un produit, un sujet ou une campagne.
  • Lorsque vous avez besoin d’une liste structurée reliant chaque publication correspondante à son mot-clé de recherche et aux métadonnées de collecte.
  • À ne pas utiliser pour
  • Lorsque vous avez besoin du texte des publications, des médias, des indicateurs d’engagement, des commentaires ou de profils d’auteurs complets.
  • Lorsque vous avez besoin d’une consultation immédiate d’un seul enregistrement plutôt que d’une collecte en arrière-plan.

Gestion des échecs

Comportement en cas d'échec et de nouvelle tentative déclaré par l'auteur. Nous vous recommandons de l'inclure dans votre prompt système lors de l'intégration.

  1. 1Si aucun enregistrement correspondant n’est renvoyé, vérifiez le mot-clé ou essayez une expression plus courte et plus large.
  2. 2Conservez les enregistrements terminés après un succès partiel; renvoyez la même saisie après une tâche en échec ou expirée.
  3. 3Réessayez plus tard après une limitation de débit, une indisponibilité temporaire ou un délai d’attente.
  4. 4En cas d’échec d’authentification, vérifiez la clé API configurée pour l’environnement d’exécution.

Entrée

Paramètres requis pour appeler cette App, générés à partir de l'input.schema du manifest.json.

ChampNom métierTypeRequisDéfautÉnum / ContraintesExempleDescription
keywordMot-clé de recherchestringOui——ShokzMarque, produit, sujet ou expression à rechercher sur Twitter. Chaque tâche accepte un mot-clé de 1 à 512 caractères.
crawl_countNombre de résultats attenduintegerOui—1–20001Nombre attendu de résultats de recherche, de 1 à 2000. Les résultats sont renvoyés par lots complets de 20, le nombre réel peut donc être arrondi à la hausse. Un lot partiel est tout de même facturé comme 20 enregistrements.

Sortie

Structure des champs d'un enregistrement, générée à partir de l'output.schema du manifest.json.

ChampNom métierTypeExempleDescription
content_idID de contenustring2092504987695714392Identifiant unique de la publication Twitter correspondante.
keywordMot-clé correspondantstringshokzMot-clé de recherche associé à la publication collectée.
keyword_typeType de mot-cléstringkeywordClassification de l’élément de recherche associé à l’enregistrement.
publish_timeDate de publicationstring2026-03-17T15:43:44Horodatage de publication de la publication; la source n’indique pas de fuseau horaire.
crawl_timeHeure de collectestring2026-08-26T18:50:22Horodatage associé à la collecte de l’enregistrement; la source n’indique pas de fuseau horaire.
clean_update_timeHeure de nettoyagestring2026-08-26T18:50:45Horodatage associé au nettoyage de l’enregistrement collecté; la source n’indique pas de fuseau horaire.
cur_idID d’enregistrement collectéstring6a8ec50697a2800ddeb6901fIdentifiant unique de cette ligne collectée; il peut différer de l’ID de contenu de la publication Twitter.
biz_idID métierstringshokzIdentifiant de regroupement métier renvoyé avec l’enregistrement collecté.
source_itemÉlément sourcestringshokzÉlément mot-clé associé à la collecte qui a produit cet enregistrement.
no_dataIndicateur sans donnéesbooleanfalseIndique si cet élément de recherche n’a produit aucun enregistrement correspondant.

Schema de l'enregistrement

La sortie est renvoyée enregistrement par enregistrement. detail.output.idFieldHint

output.schema
{
  "type": "object",
  "properties": {
    "content_id": {
      "type": "string",
      "title": "ID de contenu",
      "description": "Identifiant unique de la publication Twitter correspondante.",
      "prefill": "2092504987695714392"
    },
    "keyword": {
      "type": "string",
      "title": "Mot-clé correspondant",
      "description": "Mot-clé de recherche associé à la publication collectée.",
      "prefill": "shokz"
    },
    "keyword_type": {
      "type": "string",
      "title": "Type de mot-clé",
      "description": "Classification de l’élément de recherche associé à l’enregistrement.",
      "prefill": "keyword"
    },
    "publish_time": {
      "type": "string",
      "title": "Date de publication",
      "description": "Horodatage de publication de la publication; la source n’indique pas de fuseau horaire.",
      "prefill": "2026-03-17T15:43:44"
    },
    "crawl_time": {
      "type": "string",
      "title": "Heure de collecte",
      "description": "Horodatage associé à la collecte de l’enregistrement; la source n’indique pas de fuseau horaire.",
      "prefill": "2026-08-26T18:50:22"
    },
    "clean_update_time": {
      "type": "string",
      "title": "Heure de nettoyage",
      "description": "Horodatage associé au nettoyage de l’enregistrement collecté; la source n’indique pas de fuseau horaire.",
      "prefill": "2026-08-26T18:50:45"
    },
    "cur_id": {
      "type": "string",
      "title": "ID d’enregistrement collecté",
      "description": "Identifiant unique de cette ligne collectée; il peut différer de l’ID de contenu de la publication Twitter.",
      "prefill": "6a8ec50697a2800ddeb6901f"
    },
    "biz_id": {
      "type": "string",
      "title": "ID métier",
      "description": "Identifiant de regroupement métier renvoyé avec l’enregistrement collecté.",
      "prefill": "shokz"
    },
    "source_item": {
      "type": "string",
      "title": "Élément source",
      "description": "Élément mot-clé associé à la collecte qui a produit cet enregistrement.",
      "prefill": "shokz"
    },
    "no_data": {
      "type": "boolean",
      "title": "Indicateur sans données",
      "description": "Indique si cet élément de recherche n’a produit aucun enregistrement correspondant.",
      "prefill": false
    }
  },
  "required": [],
  "additionalProperties": false
}

Intégration

Cette App peut être intégrée via MCP, API, SDK ou export de fichiers — tous les canaux partagent les mêmes capacités et la même tarification. Chaque requête s'authentifie avec l'en-tête Authorization: Bearer à l'aide d'une API Key (longue durée, créée dans la console Data Hub) ; les clients MCP peuvent aussi se connecter via OAuth, sans clé. D'autres options comme la CLI et Skill arrivent bientôt.

Avec MCP (Model Context Protocol), vous pouvez appeler cette App directement depuis des clients IA comme Claude et Cursor. Choisissez votre client et votre mode d'authentification, puis copiez la config ci-dessous.

Config du client

Remplacez la valeur après Bearer par votre API Key longue durée. Fonctionne dans n'importe quel client, en CI ou en environnement sans navigateur.

mcpServers config
{
  "mcpServers": {
    "hello_moto__twitter-keyword-list": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=hello_moto/twitter-keyword-list",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Laissez l'IA tout configurer pour vous

Vous ne voulez pas modifier les configs à la main ? Copiez le prompt d'installation et collez-le dans n'importe quel client IA — il effectuera la configuration à sa manière. (Le prompt demande à l'IA de vous réclamer votre API Key, afin que les identifiants ne finissent jamais dans l'historique de conversation ni dans des configs partagées.)

detail.access.mcp.composeHint

Tarifs

20 enregistrements renvoyés

Facturé selon le nombre d'enregistrements renvoyés avec succès. Les exécutions échouées ne sont pas facturées. Facturé par unités de 20 enregistrement ; toute unité incomplète est arrondie à 20 enregistrement.

0,002 $US/ 20 enregistrement
Per task submitted

Facturé une fois par exécution soumise, quel que soit le nombre d'enregistrements renvoyés.

0,0001 $US/ exécution

Plusieurs événements de facturation se cumulent indépendamment. Voir chaque élément pour les détails. Les exécutions échouées ne sont pas facturées.

Voir les crédits

Essayer maintenant

Renseignez les paramètres et lancez l'exécution — les résultats proviennent d'un appel réel.

Exemple
Les paramètres sont validés par rapport à l'input.schema avant la soumission
Veuillez d'abord renseigner les paramètres requis
À partir de 0,002 $US / 20 enregistrement