{ "openapi": "3.0.1", "info": { "title": "Social Media Influencer Scraper", "description": "Discover public Instagram, TikTok, and YouTube creators by keyword or profile URL. Returns normalized audience, verification, bio, and profile-link data for influencer research.", "version": "0.6", "x-build-id": "HYLBqLTillDafFk0E" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~social-media-influencer-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-social-media-influencer-scraper", "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/khadinakbar~social-media-influencer-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-social-media-influencer-scraper", "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/khadinakbar~social-media-influencer-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-social-media-influencer-scraper", "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": { "platforms": { "title": "Platforms", "type": "array", "description": "Use this to choose which public social platforms to search. Select any combination of instagram, tiktok, and youtube; all three are the default. Discovery runs separately on each selected platform. This is not an account-login setting.", "items": { "type": "string", "enum": [ "instagram", "tiktok", "youtube" ] }, "default": [ "instagram", "tiktok", "youtube" ] }, "searchQueries": { "title": "Creator search queries", "type": "array", "description": "Use this when you want to discover public creators by niche, name, or brand query. Enter one query per line, for example 'fitness coach' or 'Miami food creator'. Leave it empty when enriching known profile URLs; an empty run uses a small health-check query. Accepts up to 20 terms. This is not a hashtag-post or video search.", "items": { "type": "string" } }, "profileUrls": { "title": "Known profile URLs or handles", "type": "array", "description": "Use this when you already know public creator profiles to enrich. Accepts profile URLs or tagged handles such as 'instagram:@natgeo' and 'youtube:@Apify'. Leave it empty for keyword discovery. This does not accept post, Reel, video, or private-profile URLs.", "items": { "type": "string" }, "default": [] }, "maxProfilesPerQuery": { "title": "Max profiles per query and platform", "minimum": 1, "maximum": 50, "type": "integer", "description": "Use this to cap returned profiles for every query-platform pair. Choose 5 for fast agent runs or up to 50 for deeper discovery. Defaults to 10 and is applied before the global run cap. This is not a follower-count filter.", "default": 10 }, "maxTotalProfiles": { "title": "Max profiles for the whole run", "minimum": 1, "maximum": 500, "type": "integer", "description": "Use this to set a hard ceiling on profiles saved and charged in this run. Choose a number from 1 to 500; the default is 100. The actor stops gracefully when it reaches this cap. This is not a request-page count.", "default": 100 }, "minFollowerCount": { "title": "Minimum audience size", "minimum": 0, "maximum": 2147483647, "type": "integer", "description": "Use this to keep creators with at least a specified public follower or subscriber count. Enter a whole number such as 5000; 0 keeps every returned public profile. Defaults to 0 and applies after provider retrieval. This is not an engagement-rate threshold.", "default": 0 }, "verifiedOnly": { "title": "Verified profiles only", "type": "boolean", "description": "Use this when a platform verification signal is required for the shortlist. Set true to keep only profiles whose provider response marks them verified. Defaults to false because verification coverage differs by platform. This is not an identity or brand-safety guarantee.", "default": false }, "excludePrivateAccounts": { "title": "Exclude private accounts", "type": "boolean", "description": "Use this to remove profiles explicitly marked private by a data provider. It defaults to true so output remains useful for public influencer research. A missing privacy flag does not imply that an account is public. This is not a way to access private content.", "default": true }, "providerOrder": { "title": "Provider order", "enum": [ "scrapecreators-first", "sociavault-first", "scrapecreators-only", "sociavault-only" ], "type": "string", "description": "Use this to select the managed-provider fallback order. ScrapeCreators first is the default and is generally cheaper; SociaVault is attempted after supported failures. Use an only option for controlled diagnostics. This is not a user API-key field.", "default": "scrapecreators-first" }, "countryCode": { "title": "YouTube search country", "minLength": 2, "maxLength": 2, "type": "string", "description": "Use this to localize YouTube creator discovery with a two-letter country code. Enter values such as US, GB, or PK; the default is US. It affects YouTube search results only. This is not a creator-location filter.", "default": "US" }, "includeRawData": { "title": "Include provider raw data", "type": "boolean", "description": "Use this only for provider-schema diagnostics when you need the original public response alongside normalized fields. It defaults to false to keep dataset records compact for agents and CSV exports. Raw payloads can change without notice. This is not required for normal creator discovery.", "default": false } } }, "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 } } } } } } } } } }