Automatio
Social API·15 credits per call

Map any Twitter social graph.

Provide a user ID and get a structured list of followers. No complex app registrations or restrictive 15-minute rate limit windows to manage.

Full API reference
POSTautomatio.ai/api/v1/query{ tool: "twitter_followers", params: { twitterUserId: … } }

How it works

One request, one response.

  1. 1

    Provide account ID

    The developer sends a POST request containing the target twitterUserId and an optional pagination cursor.

  2. 2

    Fetch follower data

    The API retrieves the current list of accounts following the specified public profile.

  3. 3

    Receive user metadata

    A JSON array of follower objects is returned, including unique IDs and essential profile fields for each user.

Capabilities

What you get.

Everything this endpoint does, without running the infrastructure yourself.

Targeted follower retrieval

Extract the full list of followers for any public account by providing its unique numerical user ID.

Standardized pagination

Use the cursor parameter to walk through millions of followers across sequential requests without data duplication.

Profile metadata access

Receive key profile details for every follower to facilitate bulk sentiment or demographic analysis.

Simplified authentication

Connect using a single Bearer token instead of navigating the platform's multi-step OAuth 2.0 flow.

High-volume throughput

Query deep follower lists at a scale that typically requires specialized or enterprise-level access on the origin platform.

Cost of ownership

Build it yourself, or call this.

Both are real options. Here is what each one actually costs you.

Build it yourself

  • Apply for X Developer access and pay for high-tier monthly plans
  • Manage restrictive 15-minute rate limit windows and implement complex backoff logic
  • Build and maintain custom pagination handlers to prevent data loss in large social graphs.

Use the API

  • Pay per successful request with no fixed monthly subscription fee
  • Access data via a single POST endpoint that abstracts infrastructure and rate-limiting
  • Receive stable JSON data ready for direct integration into AI models or custom dashboards.

Integrate

Built for the language you use.

One HTTP endpoint. Copy the call in your language and go.

example.sh
curl -X POST https://automatio.ai/api/v1/query \
  -H "Authorization: Bearer $AUTOMATIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tool": "twitter_followers", "params": { "twitterUserId": "example" } }'

In production

What people build with it.

Audience Persona Mapping

Input a brand ID to extract thousands of followers and analyze their bios and locations to build an ideal customer profile based on real users. This allows for data-driven marketing decisions without manual profile audits.

Influencer Selection Engine

Query the followers of several niche leaders to find overlapping users who represent the most active and influential community participants. Developers use this to identify micro-influencers with high cross-relevance.

Competitive Growth Auditing

Track the follower lists of rival accounts on a recurring schedule to calculate net growth and identify specific campaigns that drive user acquisition. This provides tactical intelligence on competitor distribution strategies.

Choosing parameters

Which options matter.

The table below lists what exists. These are the calls worth making deliberately.

twitterUserId
You must use the unique numerical ID, not the @username handle. If you only have the handle, resolve it first using the Twitter User endpoint to avoid 400 errors.
cursor
To paginate, copy the exact token string from the nextCursor field of the previous response. Do not attempt to guess or increment this value as it is an encoded state.
cursor
When this value is null or omitted in the response, you have reached the end of the list. Subsequent requests without a cursor will restart the retrieval from the beginning.

Alternatives

When to use something else.

A page that pretends it has no alternatives reads as an advert. These are the other real options.

Official X API

Best for enterprise applications requiring direct platform partnership that can justify high fixed monthly costs.

Manual Export

A viable option for one-time tasks on very small accounts where building an automated integration is unnecessary.

Headless Browser Scraping

Requires significant infrastructure to manage proxy rotations and evolving DOM selectors to avoid detection.

Before you integrate

What it does not do.

The boundaries are as useful as the features. These are the ones worth knowing up front.

Private profiles

This endpoint cannot retrieve follower data for accounts that have set their profile visibility to private.

Real-time streaming

This is a request-response API; it does not support webhooks for real-time notifications when a new user follows an account.

Personal contact info

The response includes public profile data only and does not contain private email addresses or phone numbers.

Reference

15 credits per call
Endpoint
POST https://automatio.ai/api/v1/query
Tool ID
twitter_followers

Parameters

NameTypeRequiredDescription
twitterUserIdstringNumeric Twitter user ID (not the @handle) — get it from twitter_user's userId field.
cursorstring—nextCursor from a previous call, to read the next page.

The same endpoints are available over MCP, and the full machine-readable catalogue lives in the API documentation.

Frequently Asked Questions

Find answers to common questions about Twitter Followers API

Same data source

Every Twitter endpoint.

One key, one endpoint shape. These all bill per successful call the same way.

Verified Followers API

Fetch verified followers for any X account to isolate high-value leads and organizations. Get structured JSON data for Blue, Gold, and Grey checkmarks.

15 credits

Tweet Lookup API

Retrieve full JSON metadata for any public X post. Get tweet text, engagement metrics, and author details for research, sentiment analysis, and archiving.

15 credits

Twitter Replies API

Retrieve structured reply threads from any public tweet. Access comment text, author metadata, and engagement metrics via JSON for sentiment analysis or...

15 credits

Twitter Search API

Search for tweets, users, and media on X using standard search syntax. Get structured JSON data for sentiment analysis, brand monitoring, and news tracking.

15 credits

Twitter Timeline API

Get recent tweets from any public Twitter profile via user ID. Extract tweet text, timestamps, and engagement data without managing browser automation.

15 credits

Twitter User API

Retrieve Twitter profile metadata including follower counts, bio, and verified status via a JSON POST request. Integrate public social data into your apps.

15 credits

Other endpoints

Browse all APIs →
Property Locations API135crAgency Listings API135crReal Estate Agency API135crIdealista Property Search API135crProperty Details API135crLocation Autocomplete API135crCrypto Market Data API5crCrypto Price API3crReddit Domain Search API5crReddit Comments API5crReddit User API5crSubreddit API5crYouTube Video Data API15crYouTube Comments API15crURL to Markdown API1crYouTube Search API15crWeb Search API1crReddit Search API5crScreenshot API2crYouTube Transcript API15cr
More than just prompts

Supercharge your workflow with AI Automation

Automatio combines the power of AI agents, web automation, and smart integrations to help you accomplish more in less time.

AI Agents
Web Automation
Smart Workflows