modash.io APImodash.io ↗
Search and analyze Instagram, TikTok, and YouTube influencers. Filter by location, followers, engagement, and more. Access full profile reports and audience data.
curl -X POST 'https://api.parse.bot/scraper/3ef2b839-94b0-460c-aebe-37e4f435e153/search_instagram_influencers' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"location": "US"
}'Search for Instagram influencers with filters like location, followers, engagement, and contact info.
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of results to return |
| cursor | string | Pagination cursor from previous response |
| api_keyrequired | string | Modash API key |
| location | string | Comma-separated location codes (e.g., 'US,GB') |
| has_email | boolean | Filter for accounts with email contact |
| is_verified | boolean | Filter for verified accounts only |
| followers_max | integer | Maximum follower count |
| followers_min | integer | Minimum follower count |
| engagement_min | number | Minimum engagement rate |
| audience_location | string | Comma-separated audience location codes |
| audience_location_weight | number | Minimum audience percentage in specified locations |
{
"type": "object",
"fields": {
"total": "integer",
"cursor": "string",
"lookalikes": "array"
},
"sample": {
"status": "error",
"message": "Unauthorized: A valid API token is needed. Please visit the account [developer section](https://marketer.modash.io/developer). Please provide a valid API key via 'api_key' parameter."
}
}About the modash.io API
This API exposes 7 endpoints for discovering and profiling influencers across Instagram, TikTok, and YouTube. You can filter search results by follower count, location, verification status, and email availability, then pull full creator reports — including audience demographics, profile stats, and contact details — using get_instagram_influencer_report. An AI-powered natural language endpoint (ai_search_influencers) lets you query creators using plain text descriptions.
Search Endpoints
Three platform-specific search endpoints — search_instagram_influencers, search_tiktok_influencers, and search_youtube_influencers — accept POST requests with filters like followers_min, followers_max, location (comma-separated country codes), has_email, and is_verified. Each returns a total count, a cursor string for paginating through result sets, and a lookalikes array containing matched creator profiles. The Instagram search supports the widest filter set, including boolean flags for verified accounts and email availability.
Creator Reports and Metadata
get_instagram_influencer_report accepts an Instagram user_id and returns three top-level objects: stats (engagement metrics and post-level data), profile (username, bio, and contact fields), and audience (demographic breakdowns including geography and age). The search_metadata endpoint lets you resolve valid filter values — locations, topics, languages, brands, interests, hashtags, and users — for a given platform, which is useful for constructing well-formed search requests.
Email and AI Search
search_influencers_by_email accepts an email address and returns any influencer accounts associated with that address across platforms, making it useful for reverse-lookup workflows. ai_search_influencers accepts a free-text query (e.g., "fitness influencers in New York") and an optional platform filter, returning a total and a lookalikes array. This endpoint lets you express multi-dimensional creator criteria without constructing explicit filter objects.
Pagination and API Key
All search endpoints support cursor-based pagination via a cursor parameter returned in each response. Every endpoint requires a Modash API key obtained from the Modash developer portal at https://marketer.modash.io/developer. The api_key parameter is passed directly in each request.
- Build an influencer discovery tool filtered by location and follower range using
search_instagram_influencers - Pull audience demographic breakdowns for a list of Instagram creators using
get_instagram_influencer_report - Reverse-lookup which social accounts belong to a known email address using
search_influencers_by_email - Populate location or hashtag filter dropdowns in a campaign UI using
search_metadata - Run natural language creator queries like 'travel vloggers in Australia' with
ai_search_influencers - Paginate through large TikTok or YouTube creator result sets using cursor-based search endpoints
- Identify verified Instagram accounts in specific markets for partnership outreach
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Modash have an official developer API?+
What does `get_instagram_influencer_report` return, and is a similar report available for TikTok or YouTube creators?+
stats (engagement and post metrics), profile (bio and contact fields), and audience (demographic data). Currently, full creator report endpoints are only available for Instagram. You can fork this API on Parse and revise it to add a TikTok or YouTube report endpoint if Modash surfaces that data.How do I get valid values for location or topic filters?+
search_metadata endpoint with the appropriate metadata_type (e.g., 'locations', 'topics', 'hashtags') and a platform value. It returns a results array of valid filter values you can pass directly into the search endpoints.Does the API expose historical performance data or post-level analytics over time?+
get_instagram_influencer_report endpoint, but does not expose time-series engagement history or individual post archives. You can fork this API on Parse and revise it to add historical trend tracking if that data becomes accessible through Modash.Are there any known coverage limitations across platforms?+
has_email, is_verified, followers_min, and followers_max. The TikTok and YouTube search endpoints expose fewer filters — primarily location and followers_min — and full creator report endpoints are not available for those platforms in the current spec.