{ "openapi": "3.0.1", "info": { "title": "Instagram TikTok YouTube Influencer Search API - Modash", "description": "Search Instagram, TikTok and YouTube influencers by followers, engagement, location, language, keywords, lookalikes and audience country, age, gender and credibility. Audience reports with fake follower types, contact emails and sponsored post stats, plus live posts and comments. Your own key.", "version": "0.1", "x-build-id": "JXSfXyiHy8AUeS80i" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nabeelbaghoor~instagram-tiktok-youtube-influencer-discovery-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nabeelbaghoor-instagram-tiktok-youtube-influencer-discovery-api", "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/nabeelbaghoor~instagram-tiktok-youtube-influencer-discovery-api/runs": { "post": { "operationId": "runs-sync-nabeelbaghoor-instagram-tiktok-youtube-influencer-discovery-api", "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/nabeelbaghoor~instagram-tiktok-youtube-influencer-discovery-api/run-sync": { "post": { "operationId": "run-sync-nabeelbaghoor-instagram-tiktok-youtube-influencer-discovery-api", "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", "properties": { "service": { "title": "What to read", "enum": [ "search", "report", "lookup", "dictionary", "rawProfile", "rawPosts", "rawComments", "rawHashtagFeed", "accountInfo" ], "type": "string", "description": "Discovery search finds creators on one network with the filters below and needs no identifiers, so it is the default. Creator audience report reads the full audience analytics of each creator in the identifiers input (1 provider credit each). Creator lookup finds creators by handle or name. Filter dictionary lists the location, language, interest, brand, topic or hashtag ids the filters take. Live profile, live posts, live comments and live hashtag feed read real-time data from the raw endpoints. Account balance reads the credits and raw requests left.", "default": "search" }, "socialNetwork": { "title": "Social network", "enum": [ "instagram", "tiktok", "youtube" ], "type": "string", "description": "The network to search or read.", "default": "instagram" }, "identifiers": { "title": "Identifiers", "type": "array", "description": "One per line. Creator audience report and live profile or posts: handles (with or without @), profile URLs or user ids; YouTube takes a channel URL, @handle or channel id. Creator lookup: handles or names. Filter dictionary: search terms (optional for locations, languages, interests and brands). Live comments: Instagram post URLs or shortcodes, or TikTok video URLs or ids. Live hashtag feed: hashtags. Discovery search and account balance read none.", "items": { "type": "string" } }, "followersMin": { "title": "Minimum followers", "minimum": 0, "type": "integer", "description": "Discovery: followers (subscribers on YouTube) at least this many. The provider rounds the value." }, "followersMax": { "title": "Maximum followers", "minimum": 0, "type": "integer", "description": "Discovery: followers (subscribers on YouTube) at most this many. The provider rounds the value." }, "engagementRateMin": { "title": "Minimum engagement rate (%)", "minimum": 0, "maximum": 100, "type": "number", "description": "Discovery: engagement rate in percent, from 0 to 100. Sent to the provider as a fraction (2 becomes 0.02)." }, "engagementsMin": { "title": "Minimum engagements", "minimum": 0, "type": "integer", "description": "Discovery: average engagements per post at least this many." }, "engagementsMax": { "title": "Maximum engagements", "minimum": 0, "type": "integer", "description": "Discovery: average engagements per post at most this many. On Instagram, 0 finds creators with hidden likes." }, "viewsMin": { "title": "Minimum average views", "minimum": 0, "type": "integer", "description": "Discovery, TikTok and YouTube: average views at least this many." }, "viewsMax": { "title": "Maximum average views", "minimum": 0, "type": "integer", "description": "Discovery, TikTok and YouTube: average views at most this many." }, "reelsPlaysMin": { "title": "Minimum reels plays", "minimum": 0, "type": "integer", "description": "Discovery, Instagram: average reels plays at least this many." }, "reelsPlaysMax": { "title": "Maximum reels plays", "minimum": 0, "type": "integer", "description": "Discovery, Instagram: average reels plays at most this many." }, "creatorLocationIds": { "title": "Creator location ids", "type": "array", "description": "Discovery: location ids of where the creator is, from the locations dictionary (Filter dictionary service), such as 148838 for the United States.", "items": { "type": "string" } }, "creatorLanguage": { "title": "Creator language", "type": "string", "description": "Discovery: language code the creator posts in, such as en, from the languages dictionary." }, "creatorGender": { "title": "Creator gender", "enum": [ "any", "MALE", "FEMALE", "KNOWN", "UNKNOWN" ], "type": "string", "description": "Discovery.", "default": "any" }, "creatorAgeMin": { "title": "Creator minimum age", "enum": [ "any", "18", "25", "35", "45", "65" ], "type": "string", "description": "Discovery: the creator's age, at least.", "default": "any" }, "creatorAgeMax": { "title": "Creator maximum age", "enum": [ "any", "18", "25", "35", "45", "65" ], "type": "string", "description": "Discovery: the creator's age, at most.", "default": "any" }, "lastPostedDays": { "title": "Posted within days", "minimum": 30, "type": "integer", "description": "Discovery: the creator posted within this many days. 30 or more." }, "bioSearch": { "title": "Bio or name contains", "type": "string", "description": "Discovery: words to find in the creator's bio or full name." }, "keywords": { "title": "Keywords in captions", "type": "string", "description": "Discovery: a phrase the creator uses in post captions or video text." }, "relevance": { "title": "Topics and lookalikes", "type": "array", "description": "Discovery: topics the creator posts about as #hashtags, or @handles of creators whose content is similar, such as #cars and @topgear. A bare word is sent as a #topic.", "items": { "type": "string" } }, "audienceRelevance": { "title": "Audience similar to", "type": "array", "description": "Discovery: @handles whose audience the creator's audience should resemble.", "items": { "type": "string" } }, "hashtags": { "title": "Hashtags used", "type": "array", "description": "Discovery, Instagram and TikTok: hashtags the creator has used, without #.", "items": { "type": "string" } }, "mentions": { "title": "Mentions used", "type": "array", "description": "Discovery, Instagram and TikTok: accounts the creator has mentioned, without @.", "items": { "type": "string" } }, "interestIds": { "title": "Creator interest ids", "type": "array", "description": "Discovery, Instagram: interest ids from the interests dictionary.", "items": { "type": "string" } }, "brandIds": { "title": "Brand ids", "type": "array", "description": "Discovery, Instagram: ids of brands the creator has worked with, from the brands dictionary.", "items": { "type": "string" } }, "accountTypes": { "title": "Instagram account types", "type": "array", "description": "Discovery, Instagram.", "items": { "type": "string", "enum": [ "1", "2", "3" ], "enumTitles": [ "Regular", "Business", "Creator" ] } }, "contactTypes": { "title": "Has contact details", "type": "array", "description": "Discovery: only creators listing each of these contact channels.", "items": { "type": "string", "enum": [ "bbm", "email", "facebook", "instagram", "itunes", "kakao", "kik", "lineid", "linktree", "pinterest", "sarahah", "sayat", "skype", "snapchat", "tiktok", "tumblr", "twitchtv", "twitter", "vk", "wechat", "youtube" ], "enumTitles": [ "BBM", "Email", "Facebook", "Instagram", "iTunes", "Kakao", "Kik", "LINE", "Linktree", "Pinterest", "Sarahah", "Sayat", "Skype", "Snapchat", "TikTok", "Tumblr", "Twitch", "Twitter (X)", "VK", "WeChat", "YouTube" ] } }, "onlyVerified": { "title": "Only verified", "type": "boolean", "description": "Discovery: only verified creators.", "default": false }, "onlySponsoredPosts": { "title": "Only creators with sponsored posts", "type": "boolean", "description": "Discovery, Instagram: creators the provider has seen post paid partnerships or commercial hashtags.", "default": false }, "onlyWithYouTube": { "title": "Only creators with a YouTube channel", "type": "boolean", "description": "Discovery, Instagram.", "default": false }, "hasAudienceData": { "title": "Has audience data", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Discovery: only creators the provider has audience data for, or all.", "default": "any" }, "followersGrowthInterval": { "title": "Follower growth period", "enum": [ "any", "i1month", "i2months", "i3months", "i4months", "i5months", "i6months" ], "type": "string", "description": "Discovery: the period follower growth is measured over, with the operator and rate below.", "default": "any" }, "followersGrowthOperator": { "title": "Follower growth comparison", "enum": [ "gt", "gte", "lt", "lte" ], "type": "string", "description": "Discovery: how growth compares to the rate below.", "default": "gt" }, "followersGrowthRate": { "title": "Follower growth rate", "minimum": 0, "type": "number", "description": "Discovery: the growth rate as the provider takes it, a fraction such as 0.01." }, "audienceLocationIds": { "title": "Audience location ids", "type": "array", "description": "Discovery: location ids the audience comes from, from the locations dictionary. Several are combined with OR.", "items": { "type": "string" } }, "audienceLocationMinPercent": { "title": "Audience location minimum share (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Discovery: the least share of the audience each location must hold. Leave blank for the provider default (20)." }, "audienceLanguage": { "title": "Audience language", "type": "string", "description": "Discovery: language code of the audience, such as en." }, "audienceLanguageMinPercent": { "title": "Audience language minimum share (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Discovery: leave blank for the provider default (20)." }, "audienceGender": { "title": "Audience gender", "enum": [ "any", "MALE", "FEMALE" ], "type": "string", "description": "Discovery: the gender the audience leans to.", "default": "any" }, "audienceGenderMinPercent": { "title": "Audience gender minimum share (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Discovery: leave blank for the provider default (50)." }, "audienceAgeGroups": { "title": "Audience age groups", "type": "array", "description": "Discovery: audience age groups, combined with OR.", "items": { "type": "string", "enum": [ "13-17", "18-24", "25-34", "35-44", "45-64", "65-" ], "enumTitles": [ "13 to 17", "18 to 24", "25 to 34", "35 to 44", "45 to 64", "65 and over" ] } }, "audienceAgeMinPercent": { "title": "Audience age minimum share (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Discovery: leave blank for the provider default (30)." }, "audienceInterestIds": { "title": "Audience interest ids", "type": "array", "description": "Discovery, Instagram: audience interest ids from the interests dictionary.", "items": { "type": "string" } }, "audienceInterestMinPercent": { "title": "Audience interest minimum share (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Discovery, Instagram: leave blank for the provider default." }, "audienceCredibilityMin": { "title": "Minimum audience credibility (%)", "minimum": 0, "maximum": 100, "type": "number", "description": "Discovery, Instagram: audience credibility, the inverse of fake followers (75 means about 25 percent fake)." }, "sortBy": { "title": "Sort by", "enum": [ "engagements", "followers", "engagementRate", "keywords", "audienceGeo", "audienceLang", "audienceGender", "audienceAge", "audienceRelevance", "relevance", "followersGrowth", "audienceInterest", "reelsPlays", "views", "shares", "saves", "likesGrowth", "viewsGrowth" ], "type": "string", "description": "Discovery: the order results come in. Audience and keyword sorts need their filter set.", "default": "followers" }, "sortDirection": { "title": "Sort direction", "enum": [ "desc", "asc" ], "type": "string", "description": "Discovery.", "default": "desc" }, "calculationMethod": { "title": "Average method", "enum": [ "median", "average" ], "type": "string", "description": "Discovery and reports: how average likes, comments and views are computed.", "default": "median" }, "includeRawReport": { "title": "Include the full report", "type": "boolean", "description": "Creator audience report: keep the provider's whole report under raw (recent, popular and sponsored posts, history, notable followers, lookalikes), alongside the flattened columns.", "default": true }, "dictionaryType": { "title": "Dictionary", "enum": [ "locations", "languages", "interests", "brands", "topics", "hashtags" ], "type": "string", "description": "Filter dictionary: which ids to list. Interests and brands are Instagram only.", "default": "locations" }, "rawPostType": { "title": "Instagram post type", "enum": [ "feed", "reels" ], "type": "string", "description": "Live posts, Instagram: the feed (12 posts a page) or reels.", "default": "feed" }, "youtubeSort": { "title": "YouTube video order", "enum": [ "dd", "p" ], "type": "string", "description": "Live posts, YouTube: newest first or most popular.", "default": "dd" }, "hashtagFeedType": { "title": "Hashtag feed type", "enum": [ "top", "recent" ], "type": "string", "description": "Live hashtag feed: top (featured posts, best coverage) or recent (a newer, partial subset).", "default": "top" }, "rawMaxPages": { "title": "Pages per identifier", "minimum": 1, "maximum": 50, "type": "integer", "description": "Live posts, comments and hashtag feed: how many pages to read per identifier. Each page takes one raw request from your plan.", "default": 3 }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many rows. Discovery reads 15 creators per page and the provider charges 0.01 credits per result, so this also caps what the run spends there. The provider serves pages 0 to 665.", "default": 100 }, "requestsPerMinute": { "title": "Requests per minute", "minimum": 1, "maximum": 300, "type": "integer", "description": "Pacing ceiling for calls to the provider. Rate limited answers are retried after a pause. The account balance service shows your plan's rate limits.", "default": 60 }, "apiKey": { "title": "API token", "type": "string", "description": "Your own API token from the developer section of the provider's app, sent as a bearer token. This actor is bring-your-own-key and never ships one. Leave blank to use the DATA_API_KEY environment secret. It is sent only to the API host and is never written to a row or logged." }, "baseUrl": { "title": "API base URL", "type": "string", "description": "Override the host the actor calls. Only useful for testing against a different environment." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }