---
title: "Zapier"
description: "Automatiza Twitter en Zapier para búsqueda de tweets, consulta de usuarios, tendencias, webhooks de plataforma y entregas seguras con cursor a través de TwexAPI."
---

Automatiza Twitter en Zapier con TwexAPI. Busca tweets, consulta usuarios, lee tweets en tendencia y enruta filas a Slack, Sheets, Airtable, HubSpot o email. TwexAPI usa una sola API key y la URL base REST `https://api.twexapi.io`.

## Elige un patrón de integración en Zapier

<CardGroup cols={2}>
  <Card title="Nodo comunitario + agente MCP" icon="bot">
    Usa un agente compatible con MCP para descubrimiento, luego haz POST de JSON estricto a un Catch Hook de Zapier.
  </Card>

  <Card title="Acciones HTTP Request" icon="link">
    Llama a la REST de TwexAPI directamente desde Webhooks by Zapier o una integración privada.
  </Card>

  <Card title="Nodo comunitario estilo n8n" icon="plug">
    Prefiere el [nodo comunitario de n8n](/guides/n8n) dedicado cuando tu equipo ya ejecuta n8n.
  </Card>
</CardGroup>

La app nativa de X en Zapier fue descontinuada. TwexAPI sigue disponible mediante Catch Hooks, HTTP Request o una app privada de Zapier.

## Requisitos previos

* [API key de TwexAPI](https://twexapi.io/dashboard)
* Cuenta de Zapier con Webhooks by Zapier
* Destino opcional de Slack, Google Sheets, Airtable, HubSpot o Gmail
* Agente opcional compatible con MCP conectado a `https://api.twexapi.io/mcp`

## Autenticación con API key

Crea una credencial reutilizable para llamadas REST de TwexAPI:

<CardGroup cols={3}>
  <Card title="Autenticación" icon="key-round">
    Selecciona Header Auth o encabezados personalizados en HTTP Request.
  </Card>

  <Card title="Nombre del encabezado" icon="braces">
    Configura el nombre del encabezado como `Authorization`.
  </Card>

  <Card title="Valor del encabezado" icon="shield-check">
    Pega `Bearer YOUR_API_KEY` como valor de la credencial.
  </Card>
</CardGroup>

Para pasos de AI Agent compatibles con MCP fuera de Zapier, configura `https://api.twexapi.io/mcp` con el encabezado `x-api-key: YOUR_API_KEY`.

## Forma de la integración

1. **Crea un Catch Hook**

    Usa Webhooks by Zapier y elige Catch Hook para entregas de agentes o POSTs externos.

2. **Recopila filas de TwexAPI**

    Usa MCP, HTTP Request o un worker externo para producir JSON estricto.

3. **Mapea campos estables**

    Usa `tweet_id` como clave de deduplicación. Mapea texto, autor, URL y campos de cursor.

4. **Enruta a destinos**

    Envía filas a Slack, Sheets, Airtable, HubSpot o email.

## Acciones iniciales

Usa HTTP Request o una app privada de Zapier para estas lecturas comunes:

<CardGroup cols={2}>
  <Card title="Buscar tweets" icon="search">
    `POST /twitter/advanced_search/page` con `searchTerms`, `sortBy` y `nextCursor`.
  </Card>

  <Card title="Obtener perfil de usuario" icon="user-round">
    `GET /twitter/{screen_name}/about`
  </Card>

  <Card title="Buscar usuarios" icon="users">
    `GET /twitter/search-user/{keyword}/{target_count}`
  </Card>

  <Card title="Obtener tendencias" icon="trending-up">
    `GET /twitter/global-trending/tweets` con filtros de país, tema y contenido.
  </Card>

  <Card title="Obtener seguidores" icon="users">
    `POST /v3/twitter/users/followers` con nombre de usuario y paginación por cursor.
  </Card>

  <Card title="Crear tweet" icon="send">
    `POST /twitter/tweets/create` después de aprobación humana y configuración de cookie.
  </Card>
</CardGroup>

### Ejemplo HTTP Request: búsqueda 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": ""
  }
}
```

## Entrega de resultados

Usa un paso Formatter o Code cuando el siguiente paso del Zap solo necesite campos estables de entrega.

<CardGroup cols={2}>
  <Card title="Página de búsqueda de tweets" icon="search">
    Guarda la consulta; mapea el `id` de cada tweet a `tweet_id`, más `text`, nombre de usuario del autor y `created_at`; conserva `has_next_page` y `next_cursor`.
  </Card>

  <Card title="Filas de perfil de usuario" icon="users">
    Guarda el `id` de origen como `user_id`, más `username`, `name`, conteos de seguidores y entrada de búsqueda.
  </Card>

  <Card title="Filas de tendencias" icon="trending-up">
    Guarda país, tema, etiqueta de contenido y filas de tweets con metadatos de la ejecución del flujo.
  </Card>

  <Card title="Escritura de tweet o respuesta" icon="send">
    Previsualiza con el [CLI](/sdks/cli) `--dry-run` antes de publicar desde Zapier. Las acciones de escritura requieren una cookie o `auth_token`.
  </Card>
</CardGroup>

## Receta 1: investigación con agente MCP a Slack

Prompt sugerido para agente MCP:

```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.
```

Pasos del Zap:

1. Catch Hook recibe el payload JSON.
2. Loop o line-item sobre `tweets`.
3. Filtra filas vacías.
4. Envía mensaje a Slack con autor, texto y URL.

## Receta 2: búsqueda programada de tweets a Google Sheets

1. Programa el Zap diaria o por hora.
2. HTTP Request llama a `POST /twitter/advanced_search/page`.
3. Itera sobre los tweets devueltos.
4. Añade `tweet_id`, autor, texto, `created_at` y URL construida a Sheets.
5. Guarda `next_cursor` en Storage by Zapier si un Zap posterior debe continuar la paginación.

## Receta 3: alerta de tweets en tendencia

```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
  }
}
```

Enruta texto resumen a Slack o email después de filtrar por engagement.

## Manejo de errores

| Estado | Comportamiento del Zap |
| ------ | ---------------------- |
| `400` | Detén y corrige el mapeo de la solicitud. |
| `401` | Falla el Zap y alerta a operaciones para reemplazar la API key. |
| `403` | Pausa hasta que se corrija el acceso a la cuenta o los créditos. |
| `429` | Retrasa y reintenta usando el replay integrado de Zapier. |
| `5xx` | Reintenta con precaución; conserva el cursor. |

## Blueprint de integración privada

Si empaquetas TwexAPI como integración privada de Zapier, empieza con una superficie pequeña y confiable:

| Recurso | Acciones |
| --- | --- |
| Tweets | Buscar tweets, obtener detalle de tweet, crear tweet después de aprobación |
| Usuarios | Obtener usuario, buscar usuarios |
| Tendencias | Obtener tweets en tendencia global |
| Seguidores | Obtener página de seguidores v3 |

Usa REST para acciones empaquetadas y MCP para flujos de descubrimiento impulsados por agentes.

## Lista de verificación de pruebas

* Prueba el Catch Hook con un payload real de entrega TwexAPI.
* Confirma que cada solicitud REST incluye `Authorization: Bearer YOUR_API_KEY`.
* Usa `tweet_id` como clave de deduplicación antes de escribir en una app de destino.
* Guarda `next_cursor` en Storage by Zapier para Zaps de seguimiento.
* Mantén acciones de escritura como borradores hasta que un humano apruebe el texto final.

## Próximos pasos

* [n8n](/guides/n8n) si tu equipo prefiere el nodo comunitario TwexAPI
* [Make](/guides/make) para enrutamiento visual de escenarios
* [Entrega MCP de agente](/mcp/agent-handoff)
* [Búsqueda avanzada de Twitter](/api-reference/search-endpoints/get-data-page-twitter-advanced-search-page-post)