{ "openapi": "3.0.1", "info": { "title": "Influencer Search and Creator Data API - Phyllo", "description": "Search Instagram, YouTube, TikTok, Twitch and X creators by followers, engagement, audience age, gender, language and location. Pull public profile analytics with audience demographics and credibility, and read creator-connected accounts, posts and audience data. Read only, bring your own keys.", "version": "0.1", "x-build-id": "kfhebaiu3kU2l6Kvs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nabeelbaghoor~creator-data-connected-accounts-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nabeelbaghoor-creator-data-connected-accounts-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~creator-data-connected-accounts-api/runs": { "post": { "operationId": "runs-sync-nabeelbaghoor-creator-data-connected-accounts-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~creator-data-connected-accounts-api/run-sync": { "post": { "operationId": "run-sync-nabeelbaghoor-creator-data-connected-accounts-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": [ "creatorSearch", "profileAnalytics", "connectedAccounts", "connectedProfiles", "connectedContents", "connectedAudience" ], "type": "string", "description": "Creator discovery search finds public creators on one platform with the filters below and needs no identifiers, so it is the default. Public profile analytics reads the full report of each public profile in the identifiers input: audience credibility, gender, age, countries, cities, languages and interests, engagement, top content, lookalikes and contacts. The four connected services read accounts that creators linked to your own app through the provider's connect flow: the accounts, their profiles, their content items with engagement, and their audience demographics.", "default": "creatorSearch" }, "platform": { "title": "Platform", "enum": [ "instagram", "youtube", "tiktok", "twitch", "twitter" ], "type": "string", "description": "Creator discovery search and public profile analytics: the platform to search, or the platform the profiles belong to.", "default": "instagram" }, "identifiers": { "title": "Identifiers", "type": "array", "description": "One per line. Public profile analytics: profile URLs, usernames or handles. Connected profiles, content and audience: connected account ids (UUIDs from the connected accounts service); connected profiles with none lists every profile. The discovery search and connected accounts read none.", "items": { "type": "string" } }, "followersMin": { "title": "Minimum followers", "minimum": 0, "type": "integer", "description": "Discovery: followers (subscribers on YouTube) at least this many." }, "followersMax": { "title": "Maximum followers", "minimum": 0, "type": "integer", "description": "Discovery: followers (subscribers on YouTube) at most this many." }, "engagementRateMin": { "title": "Minimum engagement rate (%)", "minimum": 0, "maximum": 100, "type": "number", "description": "Discovery: engagement rate in percent, at least this value." }, "averageLikesMin": { "title": "Minimum average likes", "minimum": 0, "type": "integer", "description": "Discovery: average likes per post." }, "averageLikesMax": { "title": "Maximum average likes", "minimum": 0, "type": "integer", "description": "Discovery: average likes per post." }, "averageViewsMin": { "title": "Minimum average views", "minimum": 0, "type": "integer", "description": "Discovery: average views per post or video." }, "averageViewsMax": { "title": "Maximum average views", "minimum": 0, "type": "integer", "description": "Discovery: average views per post or video." }, "creatorGender": { "title": "Creator gender", "enum": [ "ANY", "FEMALE", "MALE", "GENDER_NEUTRAL", "ORGANIZATION" ], "type": "string", "description": "Discovery: the creator's gender. Organization applies to Twitch only.", "default": "ANY" }, "creatorLanguage": { "title": "Creator language", "type": "string", "description": "Discovery: two-letter code of the language the creator posts in, such as en." }, "creatorLocationIds": { "title": "Creator location ids", "type": "array", "description": "Discovery: the provider's location ids (UUIDs from its location dictionary) of where the creator is.", "items": { "type": "string" } }, "audienceGender": { "title": "Audience gender", "enum": [ "ANY", "FEMALE", "MALE" ], "type": "string", "description": "Discovery: the gender the audience leans to, with more than the share below.", "default": "ANY" }, "audienceGenderMinPercent": { "title": "Audience gender minimum share (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Discovery: the audience share of that gender must be above this.", "default": 50 }, "audienceAgeMin": { "title": "Audience age from", "minimum": 13, "type": "integer", "description": "Discovery: youngest age of the audience age band, 13 or over." }, "audienceAgeMax": { "title": "Audience age to", "minimum": 13, "type": "integer", "description": "Discovery: oldest age of the audience age band." }, "audienceAgeMinPercent": { "title": "Audience age minimum share (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Discovery: the least share of the audience inside the age band.", "default": 25 }, "audienceLanguages": { "title": "Audience languages", "type": "array", "description": "Discovery: two-letter codes of languages the audience speaks, each at least the share below.", "items": { "type": "string" } }, "audienceLanguageMinPercent": { "title": "Audience language minimum share (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Discovery: the least audience share for each audience language.", "default": 20 }, "audienceLocationIds": { "title": "Audience location ids", "type": "array", "description": "Discovery: the provider's location ids (UUIDs from its location dictionary) the audience must come from, each above the share below.", "items": { "type": "string" } }, "audienceLocationMinPercent": { "title": "Audience location minimum share (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Discovery: the audience share each audience location must be above.", "default": 20 }, "audienceCredibilityMin": { "title": "Minimum audience credibility", "minimum": 0, "maximum": 1, "type": "number", "description": "Discovery: audience credibility score from 0 to 1, the share of the audience the provider judges genuine." }, "bioKeywords": { "title": "Bio keywords", "type": "string", "description": "Discovery: keywords found in the bio, description, or YouTube video phrases and captions." }, "bioPhrase": { "title": "Bio phrase", "type": "string", "description": "Discovery: an exact phrase the creator uses in the bio." }, "hashtags": { "title": "Hashtags", "type": "array", "description": "Discovery: hashtags the creator uses, with or without #.", "items": { "type": "string" } }, "mentions": { "title": "Mentions", "type": "array", "description": "Discovery: accounts the creator mentions, with or without @.", "items": { "type": "string" } }, "creatorLookalike": { "title": "Creators like", "type": "string", "description": "Discovery: find creators whose posts look like this handle's." }, "audienceLookalike": { "title": "Audience like", "type": "string", "description": "Discovery: find creators whose audience looks like this handle's audience." }, "isVerified": { "title": "Verified", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Discovery: platform verification status.", "default": "any" }, "hasContactDetails": { "title": "Has contact details", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Discovery: only creators that list contact details publicly.", "default": "any" }, "mustHaveEmail": { "title": "Must have an email", "type": "boolean", "description": "Discovery: only creators with a public email address.", "default": false }, "hasSponsoredPosts": { "title": "Has sponsored posts", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Discovery, Instagram only: creators that have or have not posted sponsored content.", "default": "any" }, "accountType": { "title": "Account type", "enum": [ "ANY", "BUSINESS", "CREATOR", "PERSONAL" ], "type": "string", "description": "Discovery: the platform account type.", "default": "ANY" }, "postedWithinDays": { "title": "Posted within days", "minimum": 1, "type": "integer", "description": "Discovery: the creator posted within this many days." }, "sortBy": { "title": "Sort by", "enum": [ "FOLLOWER_COUNT", "ENGAGEMENT_RATE", "AVERAGE_LIKES", "AVERAGE_VIEWS", "CONTENT_COUNT", "FOLLOWER_GROWTH", "REELS_VIEWS", "DESCRIPTION" ], "type": "string", "description": "Discovery: the order results come in, highest first. Reels views is for Instagram only. Description sorts by relevance to the bio keywords.", "default": "FOLLOWER_COUNT" }, "includeRawReport": { "title": "Include the full report", "type": "boolean", "description": "Public profile analytics: keep the provider's whole report under raw, alongside the flattened columns.", "default": true }, "accountPlatform": { "title": "Connected account platform", "enum": [ "any", "instagram", "youtube", "tiktok", "twitch", "twitter", "facebook", "linkedin", "pinterest", "substack" ], "type": "string", "description": "Connected accounts and profiles: only accounts on this platform, or all.", "default": "any" }, "connectedUserId": { "title": "User id", "type": "string", "description": "Connected accounts and profiles: only the accounts of this user (the UUID your app created for the creator)." }, "fromDate": { "title": "Content from date", "type": "string", "description": "Connected content: items published on or after this date (YYYY-MM-DD)." }, "toDate": { "title": "Content to date", "type": "string", "description": "Connected content: items published on or before this date (YYYY-MM-DD), not after today." }, "environment": { "title": "Environment", "enum": [ "production", "staging", "sandbox" ], "type": "string", "description": "Which host to call. Production returns real data, staging is for testing with real accounts, sandbox returns mock data and is never charged. Each issues its own client id and secret.", "default": "production" }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many rows. A discovery search serves at most 500 creators.", "default": 100 }, "requestsPerMinute": { "title": "Requests per minute", "minimum": 1, "maximum": 600, "type": "integer", "description": "Pacing ceiling for calls to the provider, which allows 10 per second. Rate limited answers are retried after the wait the provider gives.", "default": 300 }, "apiKey": { "title": "Client secret", "type": "string", "description": "Your own client secret, issued on the provider dashboard. 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, in the Basic authorization header, and is never written to a row or logged." }, "clientId": { "title": "Client id", "type": "string", "description": "Your client id, issued with the secret. Required with the secret. Leave blank to use the DATA_API_AUTH_ID environment secret." }, "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 } } } } } } } } } }