X/Twitter Keyword & Hashtag Tweet Search

What it returns

18 fields from the published dataset schema. Export as JSON, CSV or Excel, or read the dataset through the Apify API.

• type
• searchTerm
• text
• author.username
• createdAt
• language
• replyCount
• retweetCount
• likeCount
• quoteCount
• viewCount
• engagementRate
• isRetweet
• isQuote
• isReply
• url
• media
• collectedAt

Not in the schema among the core X (Twitter) fields: post_id, author, posted_at, reposts. The field matrix shows which other tools return them.

How it differs from the other X (Twitter) Actors

Every field it publishes also appears in at least one of the other 11 catalogue Actors for X (Twitter) with a schema, so pick on price, input options and the fields below.

Pick another Actor if you need

Input

Example input

Built from the input form's published example values and defaults.

{
  "keywords": [
    "apify"
  ],
  "maxTweets": 20,
  "searchType": "Latest",
  "language": "Any language",
  "excludeRetweets": false,
  "excludeReplies": false,
  "onlyVerifiedUsers": false,
  "onlyImages": false,
  "onlyVideos": false,
  "onlyQuotes": false,
  "matchMode": "all",
  "excludeWords": [],
  "includeLanes": [],
  "maxWindows": 0,
  "maxPasses": 0,
  "onlyNew": false,
  "monitoringEnabled": false,
  "overlapMinutes": 10,
  "maxAgeDays": 90
}

Run it from code or an AI agent

The same run through the Apify API, with the example input. You need an Apify API token; the run is billed to your account at the Store price.

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run_input = {
    "keywords": [
        "apify"
    ],
    "maxTweets": 20,
    "searchType": "Latest",
    "language": "Any language",
    "excludeRetweets": False,
    "excludeReplies": False,
    "onlyVerifiedUsers": False,
    "onlyImages": False,
    "onlyVideos": False,
    "onlyQuotes": False,
    "matchMode": "all",
    "excludeWords": [],
    "includeLanes": [],
    "maxWindows": 0,
    "maxPasses": 0,
    "onlyNew": False,
    "monitoringEnabled": False,
    "overlapMinutes": 10,
    "maxAgeDays": 90
}

run = client.actor("nimbryxo-studio/x-twitter-keyword-and-hashtag-tweet-search").call(run_input=run_input)
if run is None:
    raise RuntimeError("The Actor run was not found.")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "<YOUR_APIFY_TOKEN>" });
const input = {
    "keywords": [
        "apify"
    ],
    "maxTweets": 20,
    "searchType": "Latest",
    "language": "Any language",
    "excludeRetweets": false,
    "excludeReplies": false,
    "onlyVerifiedUsers": false,
    "onlyImages": false,
    "onlyVideos": false,
    "onlyQuotes": false,
    "matchMode": "all",
    "excludeWords": [],
    "includeLanes": [],
    "maxWindows": 0,
    "maxPasses": 0,
    "onlyNew": false,
    "monitoringEnabled": false,
    "overlapMinutes": 10,
    "maxAgeDays": 90
};

const run = await client.actor("nimbryxo-studio/x-twitter-keyword-and-hashtag-tweet-search").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

curl -X POST "https://api.apify.com/v2/actors/nimbryxo-studio~x-twitter-keyword-and-hashtag-tweet-search/run-sync-get-dataset-items"   -H "Authorization: Bearer $APIFY_TOKEN"   -H "Content-Type: application/json"   -d '{"keywords":["apify"],"maxTweets":20,"searchType":"Latest","language":"Any language","excludeRetweets":false,"excludeReplies":false,"onlyVerifiedUsers":false,"onlyImages":false,"onlyVideos":false,"onlyQuotes":false,"matchMode":"all","excludeWords":[],"includeLanes":[],"maxWindows":0,"maxPasses":0,"onlyNew":false,"monitoringEnabled":false,"overlapMinutes":10,"maxAgeDays":90}'

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=nimbryxo-studio/x-twitter-keyword-and-hashtag-tweet-search",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_TOKEN>"
      }
    }
  }
}

What a run costs

The result rate falls on higher Apify plans. Each figure is the published per-result rate times the number of results.

• Every run also has a start event, charged per GB of memory (minimum one): $0.10 on Free, $0.03 on Business. At its default memory of 4 GB a run starts at $0.40 on Free. Fewer, larger runs keep this small.
• The Free plan includes $5 of monthly usage (Apify pricing, checked 2026-11-11); at the Free rate that covers at most about 5,050 results, less start events and platform usage.
• Worked example: 10,000 results in one run on the Free plan cost $10.30 ($9.90 for results + $0.40 start), plus Apify platform usage (compute), billed separately by Apify.
• Pay per event. Platform usage (compute) is billed by Apify on top of the event prices. Compare other tools in the cost estimator.

Where it fits among X (Twitter) routes

It ranks 5 of 12 catalogue Actors for X (Twitter) on the published formula (fields, price, reliability, freshness). Its line is highlighted on the map.

What people use it for

• Find keyword mentions
• Collect hashtag posts
• Analyze post engagement

Other catalogue Actors for X (Twitter)

Similar Actors

Questions people ask

Sources

• X/Twitter Keyword & Hashtag Tweet Search on Apify Store
• Published build with input and output schema (JSON)
• X API v2 documentation