# X (twitter) Check User Follows (`datamagnet/x-twitter-check-user-follows`) Actor Checks whether one user follows another account. - **URL**: https://apify.com/datamagnet/x-twitter-check-user-follows.md - **Developed by:** [Datamagnet](https://apify.com/datamagnet) (community) - **Categories:** Social media, Lead generation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Follow Checker โ€” Follow Relationship Scraper Follow Checker is a simple social media data tool that tells you whether one username follows another account. It is designed for marketers, creators, researchers, and growth teams who need a fast way to verify a follow relationship between two accounts without manual checking. Use it to collect the latest available follower or subscription status for a specific username pair and make quicker decisions based on reliable relationship data. If you need a quick Instagram-style follow check, audience validation, or account relationship lookup, this actor gives you a clean, direct result. ### Key Features - **Check** whether one username follows another account in seconds. - **Collect** the latest available follow-status information for a specific user pair. - **Verify** individual account relationships before outreach, partnerships, or analysis. - **Return** the raw result exactly as provided, so you can review the latest available status. - **Simplify** one-off follow checks for business, research, and social media workflows. - **Support** quick lookups for usernames you already know and want to compare. - **Export** results in formats that are easy to review, share, and store. ### Use Cases #### Influencer and Creator Vetting Brands and agencies can use this actor to confirm whether a creator follows a specific account before starting a collaboration. The returned fields help teams see the relationship status for a pair of usernames and make faster decisions about audience fit, mutual interest, or partnership potential. #### Social Media Outreach Growth teams often want to know if a target account already follows a brand, founder, or campaign profile. By checking the follow status for a username pair, they can prioritize warmer outreach, personalize messages, and focus on accounts that already show some connection. #### Community and Audience Research Researchers and analysts can use the actor to study small sets of account relationships one pair at a time. The output helps them understand whether a specific user follows a specific account, which can support manual audience mapping, niche community analysis, or competitor relationship checks. #### Partnership and Networking Checks Business development teams can quickly verify whether a prospect, partner, or public figure follows a relevant account. This makes it easier to assess relationship strength, identify shared interests, and prepare more informed outreach before a meeting or introduction. #### Account Verification Workflows Support teams and moderators can use the actor to confirm relationship details when reviewing account interactions. The returned follow-check result and latest available status can help them validate claims, investigate suspicious behavior, or document account connections. ### Input | Field | Type | Required | Description | Example | |---|---|---:|---|---| | Username | String | Yes | Enter the username of the account you want to check. | jack | | Account to check | String | Yes | Enter the username of the account that may be followed. | elonmusk | ### Output | Field | Type | Description | |---|---|---| | is_follow | Boolean | Shows whether the first username follows the second account. This is the main yes-or-no result most buyers care about. | | username | String | The username that was checked, so you can easily match the result to the person you entered. | ### Sample Output ```json [ { "is_follow": true, "username": "jack" } ] ```` ### How It Works 1. You enter the username you want to check and the account you want to compare it against. 2. The actor reviews the pair and looks up the latest available follow relationship. 3. It returns the result for that specific username pair in a simple, easy-to-read format. 4. You can review the output right away and use it in your workflow, report, or spreadsheet. 5. If needed, you can repeat the process for other username pairs to build a broader picture. ### Getting Started Getting started is easy and does not require coding knowledge. Just click **Try for free**, fill in the two usernames, and click **Run**. The actor will check the relationship and return the result automatically. Your results are available in **JSON, CSV, or Excel**, so you can review them in the format that works best for your team. ### Frequently Asked Questions #### Do I need technical skills? No. This actor is built for simple use: enter two usernames, run it, and read the result. You do not need to write code or understand how the data is collected. #### How fast does it run? It is designed for quick, individual checks. In most cases, you can expect results shortly after starting the run, making it useful for fast lookups and day-to-day workflows. #### What format is the output? The results are available in JSON, CSV, or Excel. That makes it easy to review the follow status in the Apify platform or move the data into a spreadsheet or report. #### Is this legal to use? This tool is intended for lawful business, research, and operational use. You should always make sure your use complies with applicable laws, platform rules, and your organizationโ€™s policies. #### Can I schedule it to run automatically? Yes, you can automate runs if you want to check usernames on a recurring basis. This is useful for monitoring relationship changes over time or keeping a regular record of specific account pairs. # Actor input Schema ## `user` (type: `string`): Enter the username of the account you want to check. ## `follows` (type: `string`): Enter the username of the account that may be followed. ## Actor input object example ```json { "user": "jack", "follows": "elonmusk" } ``` # 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 = { "user": "jack", "follows": "elonmusk" }; // Run the Actor and wait for it to finish const run = await client.actor("datamagnet/x-twitter-check-user-follows").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 = { "user": "jack", "follows": "elonmusk", } # Run the Actor and wait for it to finish run = client.actor("datamagnet/x-twitter-check-user-follows").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 '{ "user": "jack", "follows": "elonmusk" }' | apify call datamagnet/x-twitter-check-user-follows --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=datamagnet/x-twitter-check-user-follows", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "X (twitter) Check User Follows", "description": "Checks whether one user follows another account.", "version": "0.0", "x-build-id": "IR9bet9Z7lt2LdL7O" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datamagnet~x-twitter-check-user-follows/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datamagnet-x-twitter-check-user-follows", "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/datamagnet~x-twitter-check-user-follows/runs": { "post": { "operationId": "runs-sync-datamagnet-x-twitter-check-user-follows", "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/datamagnet~x-twitter-check-user-follows/run-sync": { "post": { "operationId": "run-sync-datamagnet-x-twitter-check-user-follows", "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": [ "user", "follows" ], "properties": { "user": { "title": "Username", "type": "string", "description": "Enter the username of the account you want to check." }, "follows": { "title": "Account to check", "type": "string", "description": "Enter the username of the account that may be followed." } } }, "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 } } } } } } } } } } ```