# Twitter/X Viral Content Finder (`igview-owner/twitter-x-inspiration-posts`) Actor Find high-performing Twitter/X content ideas instantly. Discover viral posts across any country and time frame. Sort by Bookmarks, Views, or Likes to see exactly what hooks the audience. Perfect for content creators and marketers! - **URL**: https://apify.com/igview-owner/twitter-x-inspiration-posts.md - **Developed by:** [Sachin Kumar Yadav](https://apify.com/igview-owner) (community) - **Categories:** Social media, Lead generation, MCP servers - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🐦 Twitter/X Inspiration Posts Scraper – Get Top Trending Content **Discover and extract top trending, highly viral Twitter/X posts based on engagement type, geographic region, and time period. Find inspiration, analyze viral patterns, monitor trending topics, and optimize your content strategy by analyzing the most popular posts. Perfect for content creators, copywriters, social media managers, growth hackers, and market researchers!** ### 📋 Table of Contents - [Features](#features) - [Use Cases](#use-cases) - [Quick Start](#quick-start) - [Input Parameters](#input-parameters) - [Output Format](#output-format) - [Data Fields Explained](#data-fields-explained) - [FAQ](#faq) ### 🚀 Features #### **Viral Post Discovery** - **Engagement Types** - Filter trending posts by highest Likes, Replies, Quotes, Bookmarks, Shares, or Video Views. - **Geographic Filtering** - Get trending posts from specific regions: ALL, USA, FRA, or India. - **Time Periods** - Retrieve the best performing content sorted by Daily, Weekly, or Monthly periods. - **Complete Author Metadata** - Display name, username, user ID, high-resolution avatar image, description/bio, follower count, verified status, and engagement metrics. - **Detailed Interaction Stats** - Get exact numbers for likes, retweets, replies, quote tweets, bookmarks, and views. ### 🎯 Use Cases | Use Case | Description | Benefits | |----------|-------------|----------| | **Content Inspiration** | Find what formats, hooks, and topics are currently going viral | Write better posts, copy proven viral templates | | **Trend Analysis** | Keep track of daily, weekly, or monthly viral content by country | Identify shifts in public interest and hot topics | | **Growth Hacking** | Analyze the structure, media type, and length of top performing posts | Improve organic reach and click-through rates | | **Influencer Sourcing** | Locate authors who consistently write trending posts | Partner with highly engaging creators | | **Market Research** | Track what subjects are generating maximum bookmarks and replies | Formulate data-driven content marketing plans | ### ⚡ Quick Start #### 1️⃣ Discover Daily Viral Content in the USA ```json { "type": "Likes", "country": "USA", "period": "Daily" } ```` #### 2️⃣ Discover Weekly Bookmarked Posts in FRA ```json { "type": "Bookmarks", "country": "FRA", "period": "Weekly" } ``` ### 📊 Input Parameters #### Configuration Options | Parameter | Type | Required | Description | Default | |-----------|------|----------|-------------|---------| | `type` | String | No | Sort metric for trending posts. Options: `Likes`, `Replies`, `Quotes`, `Bookmarks`, `Shares`, `VideoQualityViews`. | `"Likes"` | | `country` | String | No | Geographic region. Options: `ALL`, `USA`, `FRA`. | `"USA"` | | `period` | String | No | Time range filter. Options: `Daily`, `Weekly`, `Monthly`. | `"Daily"` | ### 📤 Output Format #### **Trending Tweet Result Example** ```json { "type": "tweet", "tweet_id": "1800000000000000000", "tweet_url": "https://x.com/creator_handle/status/1800000000000000000", "text": "10 productivity hacks that will save you 20 hours a week. A thread:", "screen_name": "creator_handle", "created_at": "Wed Jun 12 10:00:00 +0000 2026", "favorites": 45000, "retweets": 8200, "replies": 950, "quotes": 420, "bookmarks": 12500, "views": "1200000", "lang": "en", "source": "Twitter for iPhone", "conversation_id": "1800000000000000000", "author_id": "12345678", "author_name": "Growth Specialist", "author_username": "creator_handle", "author_avatar": "https://pbs.twimg.com/profile_images/12345678/avatar.jpg", "author_description": "Helping creators and builders scale their business online.", "author_followers": 98000, "author_friends": 350, "author_favourites": 4500, "author_verified": true, "author_location": "New York, USA", "in_reply_to": null, "quoted_from": null, "possibly_sensitive": false, "media": null, "search_type": "Likes", "search_country": "USA", "search_period": "Daily", "scraped_at": "2026-07-08T10:45:00.000Z" } ``` ### 📈 Data Fields Explained #### **Complete Field Reference** | Field | Type | Description | |-------|------|-------------| | `tweet_id` | String | Unique status ID of the trending tweet. | | `tweet_url` | String | Direct link to view the tweet on X.com. | | `text` | String | The text content of the tweet. | | `screen_name` | String | Handle of the user who posted the tweet. | | `created_at` | String | Original post timestamp. | | `favorites` | Integer | Favorite / like count. | | `retweets` | Integer | Retweet count. | | `replies` | Integer | Reply count. | | `quotes` | Integer | Quote tweet count. | | `bookmarks` | Integer | Bookmark count. | | `views` | String/Number | View count / impressions. | | `author_id` | String | Unique user ID of the post author. | | `author_name` | String | Display name of the author. | | `author_username` | String | Username/handle of the author. | | `author_avatar` | String | Avatar image URL of the author. | | `author_followers` | Integer | Follower count of the author. | | `author_verified` | Boolean | True if the creator has a verified badge. | | `search_type` | String | The sorting type requested in inputs. | | `search_country` | String | The country requested in inputs. | | `search_period` | String | The time period requested in inputs. | | `scraped_at` | String | Extraction timestamp. | ### ❓ FAQ #### **Q: Where does the "Inspiration Posts" data come from?** **A:** The data represents real-time trending posts curated by the underlying API, highlighting top performing content across various niches. #### **Q: Can I check historical trends beyond Monthly?** **A:** The API supports Daily, Weekly, and Monthly periods. The results reflect the top posts active during those periods. *** ### Related Actors 🤝 - **[Twitter X Thread Reader Scraper](https://apify.com/igview-owner/twitter-x-thread-reader)** - **[Twitter X Recent Replies Scraper](https://apify.com/igview-owner/twitter-x-recent-replies)** - **[Twitter X Lists Timeline Scraper](https://apify.com/igview-owner/twitter-x-lists-timeline)** - **[Twitter X Profile Scraper](https://apify.com/igview-owner/twitter-x-profile-scraper)** - **[Twitter X Video Downloader](https://apify.com/igview-owner/twitter-x-video-downloader)** - **[X Profile Viewer](https://apify.com/igview-owner/x-twitter-profile-viewer)** - **[X Follower Scraper](https://apify.com/igview-owner/twitter-x-follower-scraper)** - **[X Following Scraper](https://apify.com/igview-owner/twitter-x-following-scraper)** - **[Twitter Affiliates X Scraper](https://apify.com/igview-owner/twitter-advanced-x-scraper)** *** ### 🏷️ **Keywords & Tags** `twitter inspiration posts`, `trending tweets scraper`, `viral x posts`, `twitter trending content`, `twitter copywriting tools`, `viral content discovery`, `social media inspiration`, `apify twitter scraper`, `trending content explorer` *** ### 🚀 **Get Started Now** 1. Click [**"Try for free"**](https://apify.com?fpr=ykgg9c) to run this actor in the Apify Console. 2. Select your desired Engagement Type, Country, and Period. 3. Start the run and discover top viral content in seconds! 4. Download the results in JSON, CSV, or Excel format. **⭐ If this actor is useful to your workflow, please leave a star!** *** *Built by Sachin Kumar Yadav using Apify Platform* # Actor input Schema ## `type` (type: `string`): Type of engagement to rank posts by. ## `country` (type: `string`): Filter by country or select ALL for global results. ## `period` (type: `string`): Time period for trending posts. ## Actor input object example ```json { "type": "Likes", "country": "ALL", "period": "Daily" } ``` # Actor output Schema ## `trending_overview` (type: `string`): Open the dataset view with an overview of all trending posts including author, tweet text, likes, retweets, views, and more. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "type": "Likes", "country": "ALL", "period": "Daily" }; // Run the Actor and wait for it to finish const run = await client.actor("igview-owner/twitter-x-inspiration-posts").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "type": "Likes", "country": "ALL", "period": "Daily", } # Run the Actor and wait for it to finish run = client.actor("igview-owner/twitter-x-inspiration-posts").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "type": "Likes", "country": "ALL", "period": "Daily" }' | apify call igview-owner/twitter-x-inspiration-posts --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=igview-owner/twitter-x-inspiration-posts", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Twitter/X Viral Content Finder", "description": "Find high-performing Twitter/X content ideas instantly. Discover viral posts across any country and time frame. Sort by Bookmarks, Views, or Likes to see exactly what hooks the audience. Perfect for content creators and marketers!", "version": "1.0", "x-build-id": "AypJdCkaw98hjtsOm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/igview-owner~twitter-x-inspiration-posts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-igview-owner-twitter-x-inspiration-posts", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/igview-owner~twitter-x-inspiration-posts/runs": { "post": { "operationId": "runs-sync-igview-owner-twitter-x-inspiration-posts", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/igview-owner~twitter-x-inspiration-posts/run-sync": { "post": { "operationId": "run-sync-igview-owner-twitter-x-inspiration-posts", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "type", "country", "period" ], "properties": { "type": { "title": "Engagement Type", "enum": [ "Likes", "Replies", "Quotes", "Bookmarks", "Shares", "VideoQualityViews" ], "type": "string", "description": "Type of engagement to rank posts by.", "default": "Likes" }, "country": { "title": "Country", "enum": [ "ALL", "USA", "FRA", "AFG", "ALB", "DZA", "AND", "AGO", "ATG", "ARG", "ARM", "AUS", "AUT", "AZE", "BHS", "BHR", "BGD", "BRB", "BLR", "BEL", "BLZ", "BEN", "BTN", "BOL", "BIH", "BWA", "BRA", "BRN", "BGR", "BFA", "BDI", "KHM", "CMR", "CAN", "CPV", "CAF", "TCD", "CHL", "CHN", "COL", "COM", "COG", "CRI", "CIV", "HRV", "CUB", "CYP", "CZE", "DNK", "DJI", "DMA", "DOM", "ECU", "EGY", "SLV", "GNQ", "ERI", "EST", "SWZ", "ETH", "FJI", "FIN", "GAB", "GMB", "GEO", "DEU", "GHA", "GRC", "GRD", "GTM", "GIN", "GNB", "GUY", "HTI", "HND", "HUN", "ISL", "IND", "IDN", "IRN", "IRQ", "IRL", "ISR", "ITA", "JAM", "JPN", "JOR", "KAZ", "KEN", "KIR", "KWT", "KGZ", "LAO", "LVA", "LBN", "LSO", "LBR", "LBY", "LIE", "LTU", "LUX", "MDG", "MWI", "MYS", "MDV", "MLI", "MLT", "MHL", "MRT", "MUS", "MEX", "FSM", "MDA", "MCO", "MNG", "MNE", "MAR", "MOZ", "MMR", "NAM", "NRU", "NPL", "NLD", "NZL", "NIC", "NER", "NGA", "MKD", "NOR", "OMN", "PAK", "PLW", "PAN", "PNG", "PRY", "PER", "PHL", "POL", "PRT", "QAT", "ROU", "RUS", "RWA", "KNA", "LCA", "VCT", "WSM", "SMR", "STP", "SAU", "SEN", "SRB", "SYC", "SLE", "SGP", "SVK", "SVN", "SLB", "SOM", "ZAF", "SSD", "ESP", "LKA", "SDN", "SUR", "SWE", "CHE", "SYR", "TJK", "TZA", "THA", "TLS", "TGO", "TON", "TTO", "TUN", "TUR", "TKM", "TUV", "UGA", "UKR", "ARE", "GBR", "URY", "UZB", "VUT", "VEN", "VNM", "YEM", "ZMB", "ZWE" ], "type": "string", "description": "Filter by country or select ALL for global results.", "default": "ALL" }, "period": { "title": "Time Period", "enum": [ "Daily", "Weekly", "Monthly" ], "type": "string", "description": "Time period for trending posts.", "default": "Daily" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```