Top Inspiration Posts Ranker — X Inspiration Posts Scraper

Top Inspiration Posts Ranker is an X inspiration posts scraper built for marketers, researchers, creators, and social media teams who want to quickly find the best-performing posts in a chosen country, time period, and engagement category. It helps you collect ranked X posts by likes, replies, quotes, bookmarks, shares, or video quality views without manually scrolling through feeds. Use it to spot trending content, compare performance across markets, and review clean post details ready for export or analysis. If you need fast X data collection for content research or competitive monitoring, this actor gives you a simple way to get it.

Key Features

• Extracts the top-ranked X posts for a selected country, time period, and engagement signal.
• Collects posts by daily, weekly, or monthly performance windows so you can match your research timeline.
• Focuses on one engagement metric at a time, making it easy to compare posts by the signal that matters most.
• Returns clean post details, including text previews, author information, and engagement values.
• Includes post links and available media previews so you can review content faster.
• Supports country-wide research with a simple ALL option for broader trend discovery.
• Delivers results in a format that is easy to export, share, and analyze.

Use Cases

Social Media Trend Research

Social media managers use this actor to identify which X posts are performing best in a specific country over a chosen period. By reviewing the post text, author details, and the engagement value used for ranking, they can quickly understand what kind of content is resonating with audiences.

Competitive Content Analysis

Brands and agencies can compare their own content strategy against top-performing posts from competitors or industry leaders. The returned author/account details, post links, and media previews help teams see what formats, topics, and styles are driving engagement.

Campaign Inspiration

Content creators and campaign planners use the ranked list to find inspiration for headlines, visuals, and messaging. The post preview, media information, and engagement metric make it easier to spot patterns in high-performing content before launching a new campaign.

Market-Specific Research

Researchers and international marketing teams can choose a country to focus on local trends instead of global noise. The country field, period, and ranking type make it easy to study how engagement differs across markets and time windows.

Editorial and News Monitoring

Editors and newsroom teams can track the most engaged posts around a topic or event by looking at replies, quotes, shares, or views. The post text, author identity, and link fields help them verify sources and decide which posts deserve follow-up coverage.

Performance Review and Reporting

Analysts can export the results and use them in reports for stakeholders who want a quick view of what content is winning on X. The ranked structure, engagement metric, and country/period context make the output easy to summarize in presentations or dashboards.

Input

Field	Type	Required	Description	Example
country	String	Yes	Choose the country you want to analyze, or select ALL to see results from every available country.	ALL
period	String	Yes	Choose how far back the ranking should look: daily, weekly, or monthly.	Daily
type	String	Yes	Choose the engagement signal you want to rank posts by, such as likes, replies, quotes, bookmarks, shares, or video quality views.	Likes

Output

Field	Type	Description
geo	Any	Location information for the post, if available. Useful for understanding where the content may be associated with.
lang	String	The language of the post, which helps you filter or review content by language.
text	String	The main post text or content preview, so you can quickly understand what the post is about.
type	String	The kind of post returned, such as a tweet.
media	Any	Any attached media, such as photos or other preview content, if available.
views	String	The view count or video quality view value used in the record, depending on the ranking type.
quotes	Number	How many times the post was quoted.
source	String	The posting source, such as the app or device used to publish the post.
replies	Number	How many replies the post received.
entities	Any	Extra post details such as links, mentions, and media references.
retweets	Number	How many times the post was reshared.
tweet_id	String	The unique ID of the post, useful for tracking or referencing it later.
author_id	String	The unique ID of the author account.
bookmarks	Number	How many times the post was bookmarked.
favorites	Number	How many likes the post received.
user_info	Any	Author/account details such as name, handle, follower count, and profile image.
created_at	String	The date and time the post was published.
in_reply_to	Any	The post or account this post replied to, if applicable.
quoted_from	Any	The original post that was quoted, if applicable.
screen_name	String	The author’s X handle.
edit_tweet_ids	Any	Any edit history identifiers, if available.
conversation_id	String	The conversation thread ID for the post.
limited_actions	Any	Any restrictions or limited interaction details, if available.
possibly_sensitive	Boolean	Indicates whether the post may contain sensitive content.
in_reply_to_user_id	Any	The user ID of the account this post replied to, if applicable.

Sample Output

{
  "geo": null,
  "lang": "en",
  "text": "BREAKING @TheAthleticFC\n\nFolarin Balogun will be available to play the USMNT’s round of 16 match against Belgium with his one-game red-card ban suspended. Extraordinary development...",
  "type": "tweet",
  "media": [],
  "views": "39814241",
  "quotes": 11291,
  "source": "<a href=\"http://twitter.com/download/iphone\" rel=\"nofollow\">Twitter for iPhone</a>",
  "replies": 2739,
  "entities": {
    "urls": [
      {
        "url": "https://t.co/oQ61J9btzT",
        "indices": [
          212,
          235
        ],
        "display_url": "nytimes.com/athletic/74234…",
        "expanded_url": "https://www.nytimes.com/athletic/7423410/2026/07/05/usmnt-folarin-balogun-red-card-available/?source=emp_shared_article&unlocked_article_code=1.vVA.4WFY.yf-938ITRWPH"
      }
    ],
    "user_mentions": [
      {
        "name": "The Athletic | Football",
        "id_str": "970939705629069312",
        "indices": [
          9,
          23
        ],
        "screen_name": "TheAthleticFC"
      }
    ]
  },
  "retweets": 8187,
  "tweet_id": "2073805425246454175",
  "author_id": "242077026",
  "bookmarks": 3176,
  "favorites": 56454,
  "user_info": {
    "id": "242077026",
    "name": "Adam Crafton",
    "screen_name": "AdamCrafton_",
    "followers_count": 137964,
    "profile_image_url": "https://pbs.twimg.com/profile_images/2046051180770447360/7Vtje1Lh_normal.jpg"
  },
  "created_at": "Sun Jul 05 16:25:17 +0000 2026",
  "in_reply_to": null,
  "quoted_from": null,
  "screen_name": "AdamCrafton_",
  "edit_tweet_ids": null,
  "conversation_id": "2073805425246454175",
  "limited_actions": null,
  "possibly_sensitive": false,
  "in_reply_to_user_id": null
}

How It Works

1. You choose the country, time period, and engagement type you want to study.
2. The actor gathers the top-performing X posts for that exact combination.
3. It ranks the posts by the engagement signal you selected, such as likes or replies.
4. It prepares the results with readable post text, author details, links, and media previews.
5. You review the ranked list and export it for reporting, research, or content planning.

Getting Started

Getting started is simple and does not require coding knowledge. Click Try for free, choose your country, time period, and ranking type, then click Run. In a short time, you will receive a ranked list of top X inspiration posts that you can review right away. Results are available in JSON, CSV, or Excel, making it easy to share with your team or move into your favorite spreadsheet tool.

Frequently Asked Questions

Do I need technical skills?

No. This actor is designed for business users, marketers, and researchers who want results without dealing with code. You only need to choose the country, period, and engagement type, then run it.

How fast does it run?

It is built to fetch the ranking in a single run, so it is typically quick and straightforward. The exact time depends on how much data is available for the country and time period you choose.

What format is the output?

You can export the results in JSON, CSV, or Excel. That makes it easy to review the ranked posts in a spreadsheet, share them with colleagues, or use them in reporting workflows.

Is this legal to use?

The actor is intended for lawful research, analysis, and content review. You should always make sure your use follows applicable laws, platform rules, and your organization’s internal policies.

Can I schedule it to run automatically?

Yes, you can set it up to run on a schedule if you want regular updates. This is useful for weekly trend tracking, monthly reporting, or ongoing monitoring of top posts in a specific market.