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 contenu | Mot-clé correspondant | Date de publication | Heure de collecte | Indicateur sans données |
|---|---|---|---|---|
| 2092504987695714392 | shokz | 2026-03-17T15:43:44 | 2026-08-26T18:50:22 | Non |
| 2092527502547927469 | shokz | 2025-12-19T17:41:09 | 2026-08-26T18:50:22 | Non |
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.
- 1Si aucun enregistrement correspondant n’est renvoyé, vérifiez le mot-clé ou essayez une expression plus courte et plus large.
- 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.
- 3Réessayez plus tard après une limitation de débit, une indisponibilité temporaire ou un délai d’attente.
- 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.
| Champ | Nom métier | Type | Requis | Défaut | Énum / Contraintes | Exemple | Description |
|---|---|---|---|---|---|---|---|
| keyword | Mot-clé de recherche | string | Oui | — | — | Shokz | Marque, produit, sujet ou expression à rechercher sur Twitter. Chaque tâche accepte un mot-clé de 1 à 512 caractères. |
| crawl_count | Nombre de résultats attendu | integer | Oui | — | 1–2000 | 1 | Nombre 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.
| Champ | Nom métier | Type | Exemple | Description |
|---|---|---|---|---|
| content_id | ID de contenu | string | 2092504987695714392 | Identifiant unique de la publication Twitter correspondante. |
| keyword | Mot-clé correspondant | string | shokz | Mot-clé de recherche associé à la publication collectée. |
| keyword_type | Type de mot-clé | string | keyword | Classification de l’élément de recherche associé à l’enregistrement. |
| publish_time | Date de publication | string | 2026-03-17T15:43:44 | Horodatage de publication de la publication; la source n’indique pas de fuseau horaire. |
| crawl_time | Heure de collecte | string | 2026-08-26T18:50:22 | Horodatage associé à la collecte de l’enregistrement; la source n’indique pas de fuseau horaire. |
| clean_update_time | Heure de nettoyage | string | 2026-08-26T18:50:45 | Horodatage associé au nettoyage de l’enregistrement collecté; la source n’indique pas de fuseau horaire. |
| cur_id | ID d’enregistrement collecté | string | 6a8ec50697a2800ddeb6901f | Identifiant unique de cette ligne collectée; il peut différer de l’ID de contenu de la publication Twitter. |
| biz_id | ID métier | string | shokz | Identifiant de regroupement métier renvoyé avec l’enregistrement collecté. |
| source_item | Élément source | string | shokz | Élément mot-clé associé à la collecte qui a produit cet enregistrement. |
| no_data | Indicateur sans données | boolean | false | Indique 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
{
"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": {
"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
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.
Facturé une fois par exécution soumise, quel que soit le nombre d'enregistrements renvoyés.
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éditsEssayer maintenant
Renseignez les paramètres et lancez l'exécution — les résultats proviennent d'un appel réel.