# Get the next new post from a search — X (Twitter)

Botize method — `twitter.twitter_search` (trigger).

Triggered each time a tweet is found with certain keywords, localization or specific language.

- Chronological or random order.
- You can configure it to exclude mentions and retweets.
- Allows you to use any of the search operators offered by X.

This is a trigger: it starts the task. A task has exactly one.

## Fields you set

The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps.

- `search` *(string)* — Search
- `type` *(string, one of: "all" = Apply to all tweets in chronological order; "random" = It applies to a single tweet randomly taken, default: "all")* — Search
- `exclude_mentions` *(boolean)* — It applies to a single tweet randomly taken
- `exclude_rts` *(boolean)* — Exclude mentions
- `language` *(string, one of: "" = All languages; "ca" = Català, Valencià; "de" = Deutsch; "en" = English; "es" = Español, Castellano; "fr" = Français; "it" = Italiano; "pt" = Português; "ja" = 日本語; "ko" = 한국어; "zh" = 中文; "el" = ελληνικά; "ru" = русский язык; "ar" = العربية)* — Filter by language
- `geocode` *(string)* — Filter by location

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{created_at}}` *(date)* — Created time
- `{{text}}` *(text)* — Tweet
- `{{screen_name}}` *(text)* — Account name
- `{{user_id}}` *(text)* — user Id
- `{{name}}` *(text)* — User name
- `{{file}}` *(file)* — Image/Video URL
- `{{tweet_id}}` *(text)* — Tweet Id
- `{{followers}}` *(decimal)* — Total followers

## Account

Needs a connected X (Twitter) account in Botize: https://botize.com/en/app/twitter/authenticate

## This app

Every trigger and action for X (Twitter): https://botize.com/en/app/twitter.md

## How to build this

An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan:

    https://webhook.botize.es/mcp

- Connection guide: https://botize.com/en/mcp
- Agent map: https://botize.com/llms.txt
- New account: https://botize.com/en/join (500 free operations, no card)

---
Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/twitter/twitter_search