# Threads Profile Search (`igview-owner/threads-profile-search`) Actor

Search and discover Meta Threads profiles by keyword, name, or username. Extract clean profile data including follower count, verified status, bio details, profile picture URL, and privacy settings with zero login required.

- **URL**: https://apify.com/igview-owner/threads-profile-search.md
- **Developed by:** [Sachin Kumar Yadav](https://apify.com/igview-owner) (community)
- **Categories:** Social media, Developer tools, Automation
- **Stats:** 51 total users, 0 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 🔍 Threads Profile Search – Find Users on Meta's Threads

**🚀 Search and discover profiles on Meta's Threads platform by keyword. Get username, full name, follower count, verification status, profile picture, and privacy settings. Built with Apify best practices for reliability and speed.**

### 📋 Table of Contents

- [✨ Features](#-features)
- [🎯 Use Cases](#-use-cases)
- [⚡ Quick Start](#-quick-start)
- [📊 Input Parameters](#-input-parameters)
- [📤 Output Format](#-output-format)
- [❓ FAQ](#-faq)
- [🛠️ Troubleshooting](#️-troubleshooting)
- [🏷️ Tags](#️-tags)

***

### ✨ Features

- **Profile Discovery** – Find Threads users by name, username, or any keyword
- **Clean Output** – Username, full name, follower count, verification status, and more
- **Profile Pictures** – Direct URLs to user profile images
- **Profile Links** – Auto-generated direct Threads profile URLs
- **Verification Info** – Know which accounts are verified on Threads
- **Privacy Status** – See if accounts are public or private
- **Resilient** – Retries, key rotation, rate-limit handling, and clear error messages

***

### 🎯 Use Cases

| Use Case | Description | Key Benefits |
|----------|-------------|--------------|
| Influencer Discovery | Find influencers in specific niches on Threads | Identify potential brand partners, track rising creators |
| Brand Monitoring | Search for brand-related profiles and mentions | Track brand presence, competitor analysis |
| Audience Research | Discover user profiles in specific interest areas | Understand audience demographics, engagement patterns |
| Lead Generation | Find business and professional profiles on Threads | Sales prospecting, partnership outreach |
| Social Media Auditing | Analyze profile data for verification and activity | Account verification, activity monitoring |

***

### ⚡ Quick Start

#### Basic – Single Search

```json
{
  "searchQuery": "Elon Musk"
}
```

#### Keyword – Niche Discovery

```json
{
  "searchQuery": "fitness trainer"
}
```

#### Brand – Company Search

```json
{
  "searchQuery": "Nike"
}
```

***

### 📊 Input Parameters

| Parameter | Type | Required | Description | Example |
|-----------|------|----------|-------------|---------|
| `searchQuery` | String | Yes | Search query to find Threads profiles by name, username, or keyword | `"Elon Musk"`, `"photography"`, `"tech reviewer"` |

#### Supported Search Types

- Name search: `"Elon Musk"`, `"Amelia"`
- Keyword search: `"fitness"`, `"photography"`, `"cooking"`
- Niche search: `"travel blogger"`, `"tech reviewer"`
- Brand search: `"Nike"`, `"Apple"`

***

### 📤 Output Format

#### Profile Data Structure

```json
{
  "index": 1,
  "searchQuery": "Amelia",
  "userId": "77308732416",
  "username": "amelia_56556",
  "fullName": "Angel Amelia",
  "profileUrl": "https://www.threads.net/@amelia_56556",
  "profilePicUrl": "https://scontent-lhr11-1.cdninstagram.com/...",
  "isVerified": false,
  "isActiveOnThreads": true,
  "hasOnboardedToThreads": true,
  "isPrivate": false,
  "followerCount": 609,
  "followedBy": false,
  "following": false
}
```

#### Output Fields Explained

| Field | Type | Description |
|-------|------|-------------|
| `index` | Integer | Position of the profile in search results |
| `searchQuery` | String | The search query that returned this result |
| `userId` | String | Unique Threads/Instagram user ID |
| `username` | String | Threads username (handle) |
| `fullName` | String | User's display name |
| `profileUrl` | String | Direct link to the user's Threads profile |
| `profilePicUrl` | String | URL to the user's profile picture |
| `isVerified` | Boolean | Whether the account has a verified badge |
| `isActiveOnThreads` | Boolean | Whether the user is currently active on Threads |
| `hasOnboardedToThreads` | Boolean | Whether the user has completed Threads onboarding |
| `isPrivate` | Boolean | Whether the Threads account is set to private |
| `followerCount` | Integer | Number of followers on Threads |
| `followedBy` | Boolean | Whether the user follows the authenticated account |
| `following` | Boolean | Whether the authenticated account follows this user |

***

### ❓ FAQ

- **Q: What kind of search queries can I use?**
  - You can search by a person's name (e.g., "Elon Musk"), a username, or a general keyword (e.g., "fitness", "photography"). The API matches against both usernames and display names.

- **Q: How many profiles are returned per search?**
  - Each search returns up to 16 matching profiles from the Threads platform.

- **Q: Does this work for private accounts?**
  - Yes. Private accounts will appear in search results with `isPrivate: true`, but their content is not accessible.

- **Q: What if no profiles are found?**
  - The actor will return a `no_results` record with a clear message. Try a different or broader search query.

- **Q: Is this the same as Instagram search?**
  - No. This searches specifically on Meta's Threads platform. While Threads shares the Instagram user system, the results are filtered to users who are active on Threads.

***

### 🛠️ Troubleshooting

| Issue | Cause | Solution |
|-------|-------|----------|
| "Search query is required" | Empty or missing `searchQuery` | Provide a valid search query string |
| No results returned | Query too specific or no matching profiles | Try a broader or different search term |
| Rate limit exceeded | Too many requests in a short period | Wait a few minutes and try again |
| Request timeout | Network or server issues | Retry the run; the actor has built-in retry logic |

***

### 🏷️ Tags

`threads scraper`, `threads profile search`, `threads user search`, `threads api`, `meta threads`, `threads data extractor`, `threads username search`, `threads follower count`, `threads profile finder`, `threads influencer search`, `social media scraper`, `threads verification check`, `apify actor`, `threads audience research`, `threads brand monitoring`, `threads lead generation`

***

### 🚀 Get Started Now

**Ready to search Threads profiles?**

1. Enter a **search query** (name, username, or keyword)
2. Click **Start** to run the actor
3. Download your data in **JSON, CSV, Excel, or HTML** format
4. Click ["Try for free"](https://apify.com?fpr=ykgg9c) to test the actor

**If this actor helps your workflow, please give it a star!**

***

*Built with Apify Platform*

# Actor input Schema

## `searchQuery` (type: `string`):

Enter a search query to find Threads profiles. Search for a specific person by name or use a keyword to discover profiles in a niche (e.g., 'Amelia', 'fitness', 'photography').

## Actor input object example

```json
{
  "searchQuery": "Amelia"
}
```

# Actor output Schema

## `profiles_overview` (type: `string`):

Open the dataset view with all found Threads profiles including usernames, follower counts, and verification status.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQuery": "Amelia"
};

// Run the Actor and wait for it to finish
const run = await client.actor("igview-owner/threads-profile-search").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "searchQuery": "Amelia" }

# Run the Actor and wait for it to finish
run = client.actor("igview-owner/threads-profile-search").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQuery": "Amelia"
}' |
apify call igview-owner/threads-profile-search --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,igview-owner/threads-profile-search"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/aF6DqhyRuhYrybNdX/builds/iH0ZMqT9OlXzRmu44/openapi.json