---
title: "Zapier"
description: "Construisez une automatisation Twitter Zapier pour la recherche de tweets, le lookup utilisateur, les tweets tendance, les webhooks de plateforme et les handoffs sûrs avec curseurs via TwexAPI."
---

Construisez une automatisation Twitter Zapier avec TwexAPI. Recherchez des tweets, consultez des utilisateurs, lisez les tweets tendance et routez des lignes vers Slack, Sheets, Airtable, HubSpot ou email. TwexAPI utilise une clé API et l'URL de base REST `https://api.twexapi.io`.

## Choisir un modèle d'intégration Zapier

<CardGroup cols={2}>
  <Card title="Nœud communautaire + agent MCP" icon="bot">
    Utilisez un agent compatible MCP pour la découverte, puis POSTez du JSON strict vers un Catch Hook Zapier.
  </Card>

  <Card title="Actions HTTP Request" icon="link">
    Appelez la REST TwexAPI directement depuis Webhooks by Zapier ou une intégration privée.
  </Card>

  <Card title="Nœud communautaire style n8n" icon="plug">
    Préférez le [nœud communautaire n8n](/guides/n8n) dédié lorsque votre équipe exécute déjà n8n.
  </Card>
</CardGroup>

L'application native Zapier X a été décommissionnée. TwexAPI reste disponible via Catch Hooks, HTTP Request ou une application Zapier privée.

## Prérequis

* [Clé API TwexAPI](https://twexapi.io/dashboard)
* Compte Zapier avec Webhooks by Zapier
* Destination Slack, Google Sheets, Airtable, HubSpot ou Gmail optionnelle
* Agent compatible MCP connecté à `https://api.twexapi.io/mcp` optionnel

## Authentification clé API

Créez un identifiant réutilisable pour les appels REST TwexAPI :

<CardGroup cols={3}>
  <Card title="Authentification" icon="key-round">
    Sélectionnez Header Auth ou headers personnalisés dans HTTP Request.
  </Card>

  <Card title="Nom du header" icon="braces">
    Définissez le nom du header à `Authorization`.
  </Card>

  <Card title="Valeur du header" icon="shield-check">
    Collez `Bearer YOUR_API_KEY` comme valeur d'identifiant.
  </Card>
</CardGroup>

Pour les étapes AI Agent compatibles MCP en dehors de Zapier, configurez `https://api.twexapi.io/mcp` avec le header `x-api-key: YOUR_API_KEY`.

## Forme d'intégration

1. **Créer un Catch Hook**

    Utilisez Webhooks by Zapier et choisissez Catch Hook pour les handoffs agent ou POSTs externes.

2. **Collecter les lignes TwexAPI**

    Utilisez MCP, HTTP Request ou un worker externe pour produire du JSON strict.

3. **Mapper les champs stables**

    Utilisez `tweet_id` comme clé de déduplication. Mappez le texte, l'auteur, l'URL et les champs curseur.

4. **Router vers les destinations**

    Envoyez les lignes vers Slack, Sheets, Airtable, HubSpot ou email.

## Actions de démarrage

Utilisez HTTP Request ou une application Zapier privée pour ces lectures courantes :

<CardGroup cols={2}>
  <Card title="Rechercher des tweets" icon="search">
    `POST /twitter/advanced_search/page` avec `searchTerms`, `sortBy` et `nextCursor`.
  </Card>

  <Card title="Obtenir le profil utilisateur" icon="user-round">
    `GET /twitter/{screen_name}/about`
  </Card>

  <Card title="Rechercher des utilisateurs" icon="users">
    `GET /twitter/search-user/{keyword}/{target_count}`
  </Card>

  <Card title="Obtenir les tendances" icon="trending-up">
    `GET /twitter/global-trending/tweets` avec filtres country, topic et content.
  </Card>

  <Card title="Obtenir les abonnés" icon="users">
    `POST /v3/twitter/users/followers` avec username et pagination par curseur.
  </Card>

  <Card title="Créer un tweet" icon="send">
    `POST /twitter/tweets/create` après approbation humaine et configuration cookie.
  </Card>
</CardGroup>

### Exemple HTTP Request : recherche de tweets

```json
{
  "method": "POST",
  "url": "https://api.twexapi.io/twitter/advanced_search/page",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  "body": {
    "searchTerms": ["AI agents lang:en"],
    "sortBy": "Latest",
    "nextCursor": ""
  }
}
```

## Handoff de résultats

Utilisez une étape Formatter ou Code lorsque l'étape Zap suivante n'a besoin que de champs de handoff stables.

<CardGroup cols={2}>
  <Card title="Page de recherche de tweets" icon="search">
    Stockez la requête ; mappez chaque tweet `id` vers `tweet_id`, plus `text`, username d'auteur et `created_at` ; gardez `has_next_page` et `next_cursor`.
  </Card>

  <Card title="Lignes de profil utilisateur" icon="users">
    Stockez le `id` source comme `user_id`, plus `username`, `name`, compteurs d'abonnés et entrée de lookup.
  </Card>

  <Card title="Lignes de tendances" icon="trending-up">
    Stockez le pays, le sujet, le tag de contenu et les lignes de tweet avec les métadonnées d'exécution du workflow.
  </Card>

  <Card title="Écriture de tweet ou réponse" icon="send">
    Prévisualisez avec le [CLI](/sdks/cli) `--dry-run` avant de publier depuis Zapier. Les actions d'écriture nécessitent un cookie ou `auth_token`.
  </Card>
</CardGroup>

## Recette 1 : recherche agent MCP vers Slack

Prompt agent MCP suggéré :

```text
Find recent posts about AI agents in fintech, group them by theme, and list 5 accounts worth monitoring.
Return only JSON with route_used, tweets, has_more, and next_cursor.
Each tweet must include tweet_id, author_username, text, created_at, and public_url.
Do not call write endpoints.
```

Étapes Zap :

1. Catch Hook reçoit le payload JSON.
2. Loop ou line-item sur `tweets`.
3. Filtrez les lignes vides.
4. Envoyez un message Slack avec auteur, texte et URL.

## Recette 2 : recherche de tweets planifiée vers Google Sheets

1. Planifiez le Zap quotidiennement ou horairement.
2. HTTP Request appelle `POST /twitter/advanced_search/page`.
3. Loop sur les tweets retournés.
4. Ajoutez `tweet_id`, auteur, texte, `created_at` et URL construite à Sheets.
5. Stockez `next_cursor` dans Storage by Zapier si un Zap ultérieur doit continuer la pagination.

## Recette 3 : alerte tweets tendance

```json
{
  "method": "GET",
  "url": "https://api.twexapi.io/twitter/global-trending/tweets",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  },
  "query": {
    "country": "United States",
    "topic": "Sports",
    "content": "NFL",
    "count": 20
  }
}
```

Routez le texte de résumé vers Slack ou email après filtrage par engagement.

## Gestion des erreurs

| Statut | Comportement Zap |
| ------ | ------------ |
| `400` | Arrêtez et corrigez le mapping de requête. |
| `401` | Échouez le Zap et alertez ops pour remplacer la clé API. |
| `403` | Pausez jusqu'à correction de l'accès au compte ou des crédits. |
| `429` | Retardez et réessayez avec le replay intégré de Zapier. |
| `5xx` | Réessayez avec prudence ; préservez le curseur. |

## Blueprint d'intégration privée

Si vous packagez TwexAPI comme intégration Zapier privée, commencez avec une surface petite et fiable :

| Ressource | Actions |
| --- | --- |
| Tweets | Rechercher tweets, obtenir détail tweet, créer tweet après approbation |
| Users | Obtenir utilisateur, rechercher utilisateurs |
| Trends | Obtenir tweets tendance globaux |
| Followers | Obtenir page abonnés v3 |

Utilisez REST pour les actions packagées et MCP pour les workflows de découverte pilotés par agent.

## Checklist de test

* Testez le Catch Hook avec un payload de handoff TwexAPI réel.
* Confirmez que chaque requête REST inclut `Authorization: Bearer YOUR_API_KEY`.
* Utilisez `tweet_id` comme clé de déduplication avant écriture vers une app de destination.
* Stockez `next_cursor` dans Storage by Zapier pour les Zaps de suivi.
* Gardez les actions d'écriture comme drafts jusqu'à approbation humaine du texte final.

## Prochaines étapes

* [n8n](/guides/n8n) si votre équipe préfère le nœud communautaire TwexAPI
* [Make](/guides/make) pour le routage visuel de scénarios
* [Agent MCP Handoff](/mcp/agent-handoff)
* [Advanced Twitter Search](/api-reference/search-endpoints/get-data-page-twitter-advanced-search-page-post)