# Social Media Influencer Finder — Modash Alternative (`khadinakbar/modash-alternative`) Actor

Find public Instagram, TikTok, or YouTube creators by keyword or hashtag. Export profile snapshots, available recent-content metrics, engagement estimates, and sponsorship cues for an initial influencer shortlist.

- **URL**: https://apify.com/khadinakbar/modash-alternative.md
- **Developed by:** [Khadin Akbar](https://apify.com/khadinakbar) (community)
- **Categories:** Social media, MCP servers
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $60.00 / 1,000 creator discovery results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Social Media Influencer Finder — Modash Alternative

Find public Instagram, TikTok, or YouTube creators by keyword or hashtag. Export profile snapshots, available recent-content metrics, engagement estimates, and sponsorship cues for an initial influencer shortlist. For agency researchers, each dataset item is one public creator profile snapshot from the selected platform and query.

### Workflow: put the results to work

Pick one platform and a specific niche keyword or hashtag. Use the public profile snapshots to build an initial shortlist, then review recent content before outreach. Audience demographics, creator relationships, and campaign operations belong in your broader program workflow.

### Best fit for this Actor

- Start with one platform and a precise public niche, handle fragment, or hashtag, such as `fitness coach` on TikTok.
- Use a small result cap first, then use source URLs and collection time to decide which public profiles need human review.
- This Actor works as a focused standalone workflow: start with a public discovery query, review source-linked results, then pass the selected creator handles to the existing Influencer Marketing Intelligence Scraper for cross-platform profile review.

### What one result contains

| Field | Meaning |
| --- | --- |
| `profileUrl`, `platform`, `handle`, `displayName` | Public creator identity and source provenance. |
| `discoveryQuery`, `discoveryQueryType`, `discoveryProvider` | The bounded public search that surfaced the creator. |
| `followerCount`, `contentCount`, `verified` | Public profile indicators when the platform returns them. |
| `recentPosts` | Capped public post or video evidence used for visible metrics. |
| `averageLikeCount`, `averageCommentCount`, `averageViewCount` | Means from the returned public recent content, or `null` if unavailable. |
| `estimatedEngagementRate` | Visible likes plus comments divided by public followers; audience quality, conversion, fraud, and brand fit require separate assessment. |
| `sponsorSignalPosts` | Text-based public disclosure cues such as `#ad`, sponsored, affiliate language, or discount codes. Human campaign records confirm commercial relationships. |
| `provider`, `postProvider`, `scrapedAt` | Retrieval route and ISO 8601 collection time. |

### How this workflow compares with Modash

| Decision | This Actor | Modash | Best fit |
| --- | --- | --- | --- |
| Discovery scope | One public platform and one bounded keyword or hashtag query. | A broader creator-discovery and influencer-program product. | Use this Actor for a narrowly scoped public export. |
| Profile evidence | Source URL, returned public profile data, capped recent content, and clear nulls. | Broader analyzed profile, audience, collaboration, and platform capabilities may be available in the selected Modash product. | Use this Actor when public evidence is sufficient for initial review. |
| Output | One JSON or CSV-ready record per validated creator, with provider and collection time. | Managed product and API workflows. | Use this Actor when an API pipeline needs a small, inspectable export. |
| Operating model | Pay per validated result plus Apify platform usage. | Modash plan and API pricing depend on the product and usage. | Compare the same query, output fields, and volume before making a cost decision. |
| Effective efficiency | A bounded input and output cap make operator review and per-result event cost explicit. | Modash provides a broader operating surface with workflow depth appropriate to a program. | Compare usable source-linked results, elapsed time, and operator review effort on the same query. |
| Broader workflow | Public discovery export, profile evidence, and reviewable recent content. | Global indexed discovery, audience analysis, CRM, campaign tracking, payments, and sales attribution. | Choose Modash when the campaign program is the job. |

Modash is a trademark of its owner. This independent Actor is not affiliated, associated, or endorsed by Modash.

### Quick start

```json
{
  "platform": "tiktok",
  "query": "fitness coach",
  "queryType": "creator",
  "maxResults": 10,
  "minFollowers": 1000,
  "maxRecentPosts": 5,
  "providerOrder": "scrapecreators-first",
  "countryCode": "US"
}
```

`creator` searches public creator or channel matches. `keyword` and `hashtag` discover creators observed in matching public content; each route supplies a bounded platform-search result rather than a platform-wide index. The Actor writes and charges a dataset item only after a candidate becomes a resolvable public profile.

### Input reference

| Field | Required | What it controls |
| --- | --- | --- |
| `platform` | Yes | One public discovery platform: Instagram, TikTok, or YouTube. |
| `query` | Yes | A 2–120 character public niche, handle fragment, or hashtag phrase. |
| `queryType` | No | `creator`, `keyword`, or `hashtag`; defaults to `creator`. |
| `maxResults` | No | Maximum validated creators written, from 1 to 20; defaults to 10. |
| `minFollowers` | No | Post-enrichment public follower or subscriber threshold; defaults to 1000. |
| `maxRecentPosts` | No | Public posts or videos inspected per creator, from 1 to 10; defaults to 5. |
| `providerOrder` | No | Owner-managed public-data route order. ScrapeCreators is the documented lower-cost primary for overlapping routes. |
| `countryCode` | No | Two-letter country code used only by supported public search routes; defaults to `US`. |

### Example result

```json
{
  "recordType": "creator-discovery-result",
  "platform": "tiktok",
  "discoveryQuery": "fitness coach",
  "discoveryQueryType": "creator",
  "profileUrl": "https://www.tiktok.com/@examplecoach",
  "handle": "examplecoach",
  "followerCount": 42000,
  "averageLikeCount": 1800,
  "averageCommentCount": 62,
  "estimatedEngagementRate": 4.43,
  "sponsorSignalCount": 1,
  "provider": "scrapecreators",
  "scrapedAt": "2026-09-07T12:00:00.000Z"
}
```

### Provider routes and reliability boundary

ScrapeCreators is the primary route for documented public Instagram, TikTok, and YouTube discovery and enrichment endpoints. Its one-time, non-recurring credits make the actor owner-managed and pay-per-use. SociaVault is a supported secondary route for overlapping TikTok and YouTube public discovery and enrichment paths. Instagram discovery uses ScrapeCreators because it exposes the documented public profile-search route.

Both providers return public-data responses while caller social-media cookies and credentials remain absent. Available data comprises documented public endpoints; private accounts, private audience data, email databases, historic campaign reporting, and confirmed partnerships remain outside this public-data workflow. Missing provider configuration or an unavailable public route produces an explicit `OUTPUT` and `RUN_SUMMARY` outcome.

### API and agent use

Run the actor, then read the default dataset and the `OUTPUT` and `RUN_SUMMARY` records. A suitable agent prompt is:

> Find up to ten public TikTok fitness coaches. Return the profile source, follower count, visible recent-content metrics, sponsorship-disclosure cues, provider, and collection time. Treat all metrics as public snapshots; audience demographics and partnership confirmation remain outside the result.

```bash
curl -X POST "https://api.apify.com/v2/acts/khadinakbar~modash-alternative/runs" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"platform":"tiktok","query":"fitness coach","queryType":"creator","maxResults":5}'
```

For hosted Apify MCP, use the current client-specific setup and have the agent inspect `OUTPUT.outcome`, row-level source URLs, provider labels, and `scrapedAt` before shortlisting creators. This Actor performs read-only public-data collection; social posting, outreach, and payment actions remain with the operator's approved workflow.

### Result interpretation

The `OUTPUT` and `RUN_SUMMARY` records provide the terminal outcome, item and charge counts, provider route attempts, warnings, and source provenance. Successful public discovery uses `COMPLETE`, `PARTIAL`, `VALID_EMPTY`, or `INVALID_INPUT`; provider configuration and public-route availability are represented explicitly in the terminal records.

### Best results and responsible use

- Start with one clear public niche and a five- to ten-result cap; broaden only after reviewing sources and collection time.
- Treat platform visibility, follower counts, public posts, and engagement estimates as snapshots that can change.
- Use public profiles you are authorized to collect and assess under applicable laws, platform terms, and your organization’s research policies.
- Confirm audience fit, brand safety, commercial relationships, and campaign decisions through an appropriate human review process.

### Builder's note

I designed the retrieval flow to separate discovery from profile enrichment because public social search pages are often shallow and volatile. A candidate earns a billable record only after the actor can normalize a real public profile with provenance; this keeps search snippets and incomplete route responses outside the dataset.

### Pricing and run costs

This Actor uses **Pay per event plus Apify platform usage**. The [Pricing tab](https://apify.com/khadinakbar/modash-alternative/pricing) lists the current event rates and billing terms.

| Event | Billing unit | When it applies |
|---|---|---|
| `apify-actor-start` | Actor Start | Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). |
| `creator-discovery-result` | Creator discovery result | Charged when one validated source-linked public creator discovery result is written. |

Run cost combines the charged events and Apify platform usage. Review the run charge limit and requested result count before starting.

### Connect an AI agent

Use the [Apify MCP configurator](https://mcp.apify.com) to choose an available client connection. Inspect this Actor’s current input schema and required credentials before running it.

# Actor input Schema

## `platform` (type: `string`):

Choose the public platform where the discovery query runs. Use instagram, tiktok, or youtube; for example, tiktok finds public TikTok creators. Results stay on this one platform per run for comparable public metrics. This is not a request to link accounts across platforms or collect private audience demographics.

## `query` (type: `string`):

Enter the public discovery phrase used on the selected platform, for example fitness coach or #homeworkout. Use a niche, topic, handle fragment, or hashtag with 2 to 120 characters. Results come from the provider's public platform search and are enriched only when a resolvable public creator profile is found. This is not a natural-language audience-demographic, fraud, or brand-affinity query.

## `queryType` (type: `string`):

Select how the public platform search interprets query. Creator searches public profile or channel matches; keyword finds creators observed in relevant public content; hashtag finds creators observed in public hashtag content. Defaults to creator for a direct creator search. This is not a guarantee that a platform-wide creator database or every matching account is searched.

## `maxResults` (type: `integer`):

Caps validated creator records written for this discovery query. Choose 5 for a quick review or up to 20 for a bounded shortlist; the default is 10. The cap also limits billable discovery results and downstream profile enrichment. This is not a request for unbounded pagination or an estimate of total matching creators.

## `minFollowers` (type: `integer`):

Exclude an enriched creator when the returned public follower or subscriber count is below this threshold. Enter 0 to keep every resolvable public creator; the default is 1000. The check happens after profile enrichment because search listings can be shallow. This is not a verified reach, audience-quality, or fake-follower filter.

## `maxRecentPosts` (type: `integer`):

Sets the maximum returned public posts or videos inspected for each enriched creator. Use 5 for a balanced public-performance snapshot or up to 10 for deeper visible-content review; the default is 5. Missing or unavailable public posts remain explicit as null or zero-count evidence. This is not a historical archive, audience report, or confirmed sponsorship record.

## `providerOrder` (type: `string`):

Choose the owner-managed public-data route used first for supported platform searches and enrichments. ScrapeCreators is the default primary because its documented one-time credit cost is lower for overlapping public routes; SociaVault is tried after a supported failure. This setting never accepts a customer API key or social credential. It is not a promise that SociaVault supports every Instagram discovery route.

## `countryCode` (type: `string`):

Optional two-letter country code sent only to discovery routes that document a region parameter, for example US. Defaults to US to keep platform search behavior predictable; leave the default unless the discovery task is country-specific. It is not a filter for creator residence, audience location, or citizenship.

## Actor input object example

```json
{
  "platform": "tiktok",
  "query": "fitness coach",
  "queryType": "creator",
  "maxResults": 10,
  "minFollowers": 1000,
  "maxRecentPosts": 5,
  "providerOrder": "scrapecreators-first",
  "countryCode": "US"
}
```

# Actor output Schema

## `results` (type: `string`):

Normalized public creator discovery and recent-content intelligence records.

## `output` (type: `string`):

Compact terminal outcome, counts, billing, and warnings.

## `runSummary` (type: `string`):

Provider attempts and detailed terminal diagnostics.

# 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 = {
    "platform": "tiktok",
    "query": "fitness coach",
    "queryType": "creator",
    "maxResults": 10,
    "minFollowers": 1000,
    "maxRecentPosts": 5,
    "providerOrder": "scrapecreators-first",
    "countryCode": "US"
};

// Run the Actor and wait for it to finish
const run = await client.actor("khadinakbar/modash-alternative").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 = {
    "platform": "tiktok",
    "query": "fitness coach",
    "queryType": "creator",
    "maxResults": 10,
    "minFollowers": 1000,
    "maxRecentPosts": 5,
    "providerOrder": "scrapecreators-first",
    "countryCode": "US",
}

# Run the Actor and wait for it to finish
run = client.actor("khadinakbar/modash-alternative").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 '{
  "platform": "tiktok",
  "query": "fitness coach",
  "queryType": "creator",
  "maxResults": 10,
  "minFollowers": 1000,
  "maxRecentPosts": 5,
  "providerOrder": "scrapecreators-first",
  "countryCode": "US"
}' |
apify call khadinakbar/modash-alternative --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,khadinakbar/modash-alternative"
        }
    }
}

```

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/4MQUVcavBFepsvMsQ/builds/hen8qiSiCIHIUsceU/openapi.json