{
  "openapi": "3.0.1",
  "info": {
    "title": "LinkedIn Influencer / Creator Finder",
    "description": "Discover and rank LinkedIn creators, thought leaders and Top Voices by niche - follower reach, Top Voice badge, posting frequency, average and median engagement, engagement rate, topic relevance and an explainable creator score, with evidence posts. One row per creator. No LinkedIn login or cookies.",
    "version": "1.0",
    "x-build-id": "vYJ7jKChMjnM5e7fD"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/coregent~linkedin-influencer-creator-finder/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-coregent-linkedin-influencer-creator-finder",
        "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/coregent~linkedin-influencer-creator-finder/runs": {
      "post": {
        "operationId": "runs-sync-coregent-linkedin-influencer-creator-finder",
        "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/coregent~linkedin-influencer-creator-finder/run-sync": {
      "post": {
        "operationId": "run-sync-coregent-linkedin-influencer-creator-finder",
        "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": {
          "mode": {
            "title": "Discovery mode",
            "enum": [
              "HYBRID",
              "TOPIC",
              "KEYWORD",
              "TOP_CONTENT",
              "PROFILE_SEEDS"
            ],
            "type": "string",
            "description": "How candidate creators are found. TOPIC: authors of LinkedIn Top Content pages that match your topics, plus similar profiles. KEYWORD: the same discovery driven by your keywords. TOP_CONTENT: Top Content authors only (topics optional). PROFILE_SEEDS: score the profile URLs you provide. HYBRID (recommended): all of the above together.",
            "default": "HYBRID"
          },
          "topics": {
            "title": "Topics / niches",
            "maxItems": 25,
            "type": "array",
            "description": "Niches to find creators for, e.g. \"artificial intelligence\", \"B2B marketing\", \"cybersecurity\", \"leadership\", \"sales\". Up to 25.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "keywords": {
            "title": "Keywords",
            "maxItems": 50,
            "type": "array",
            "description": "Optional extra terms, e.g. \"AI agents\", \"founder-led growth\", \"enterprise sales\". Used for discovery and reported as matchedKeywords.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "profileUrls": {
            "title": "Profile URLs",
            "maxItems": 1000,
            "type": "array",
            "description": "LinkedIn profile URLs to score as creators (https://www.linkedin.com/in/...). Required for PROFILE_SEEDS mode, optional in HYBRID. Up to 1,000.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Creator locations",
            "type": "array",
            "description": "Keep creators whose PROFILE location matches, e.g. \"Australia\", \"London\", \"United States\". This is where the creator lives, not where their audience is. Profiles without a public location are excluded when this is set.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "industries": {
            "title": "Industries",
            "type": "array",
            "description": "Approximate industry filter, e.g. \"Software\", \"Marketing\", \"Financial Services\". Matched against headline, About, company and Top Content category - LinkedIn's guest profile has no industry field.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "jobTitleKeywords": {
            "title": "Job title keywords",
            "type": "array",
            "description": "Keep creators whose headline or title contains one of these, e.g. \"Founder\", \"CMO\", \"Author\", \"Speaker\". Leave empty - many strong creators have ordinary business titles.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "minFollowers": {
            "title": "Minimum followers",
            "minimum": 0,
            "type": "integer",
            "description": "Exclude creators with fewer followers. 0 = no minimum. Creators whose follower count is not public are excluded when this is above 0.",
            "default": 0
          },
          "maxFollowers": {
            "title": "Maximum followers",
            "minimum": 0,
            "type": "integer",
            "description": "Exclude creators with more followers - useful for finding micro and mid-tier creators. 0 = no maximum.",
            "default": 0
          },
          "creatorTiers": {
            "title": "Creator tiers",
            "type": "array",
            "description": "Keep only these tiers. NANO < 5K followers, MICRO 5K-25K, MID 25K-100K, MACRO > 100K. TOP_VOICE keeps LinkedIn Top Voices of any size. Empty = all tiers.",
            "items": {
              "type": "string",
              "enum": [
                "NANO",
                "MICRO",
                "MID",
                "MACRO",
                "TOP_VOICE"
              ],
              "enumTitles": [
                "Nano (< 5K)",
                "Micro (5K-25K)",
                "Mid (25K-100K)",
                "Macro (> 100K)",
                "Top Voice (any size)"
              ]
            },
            "default": []
          },
          "onlyTopVoice": {
            "title": "Only LinkedIn Top Voices",
            "type": "boolean",
            "description": "Keep only creators whose public profile shows the LinkedIn Top Voice badge.",
            "default": false
          },
          "requireRecentPosts": {
            "title": "Require recent public posts",
            "type": "boolean",
            "description": "Exclude profiles with no public post in the recent-days window. Recommended - a profile without public content is not a creator.",
            "default": true
          },
          "postsPerCreator": {
            "title": "Posts analysed per creator",
            "minimum": 1,
            "maximum": 25,
            "type": "integer",
            "description": "Maximum recent posts used for the metrics. LinkedIn's public profile shows roughly the latest 8 posts plus recent articles, so values above ~10 rarely add more.",
            "default": 10
          },
          "recentDays": {
            "title": "Recent window (days)",
            "minimum": 7,
            "maximum": 730,
            "type": "integer",
            "description": "Only posts published within this many days count toward activity and engagement. Typical: 30, 60, 90, 180, 365.",
            "default": 90
          },
          "minPostsInWindow": {
            "title": "Minimum posts in window",
            "minimum": 0,
            "maximum": 25,
            "type": "integer",
            "description": "Exclude creators with fewer public posts inside the recent window.",
            "default": 2
          },
          "minAverageReactions": {
            "title": "Minimum average reactions",
            "minimum": 0,
            "type": "integer",
            "description": "Exclude creators whose analysed posts average fewer reactions. 0 = off.",
            "default": 0
          },
          "minAverageComments": {
            "title": "Minimum average comments",
            "minimum": 0,
            "type": "integer",
            "description": "Exclude creators whose analysed posts average fewer comments. 0 = off.",
            "default": 0
          },
          "minEngagementRate": {
            "title": "Minimum engagement rate",
            "type": "string",
            "description": "Average (reactions + comments) per post divided by followers, as a decimal - e.g. 0.01 = 1%. Creators without a public follower count are excluded when this is set. 0 = off.",
            "default": "0"
          },
          "minTopicRelevance": {
            "title": "Minimum topic relevance (0-100)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Exclude creators whose profile and recent posts match your topics less than this. Ignored when no topics or keywords are given.",
            "default": 40
          },
          "maxCreators": {
            "title": "Maximum creators",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum ranked creators to return. You are charged only for creators delivered.",
            "default": 100
          },
          "sortBy": {
            "title": "Rank by",
            "enum": [
              "CREATOR_SCORE",
              "TOPIC_RELEVANCE",
              "FOLLOWERS",
              "AVG_REACTIONS",
              "AVG_COMMENTS",
              "ENGAGEMENT_RATE",
              "POSTING_FREQUENCY"
            ],
            "type": "string",
            "description": "Ranking key for the delivered creators.",
            "default": "CREATOR_SCORE"
          },
          "includeEvidencePosts": {
            "title": "Include evidence posts",
            "type": "boolean",
            "description": "Attach the creator's most relevant recent posts (chosen by topic match, engagement and recency - not just the most-liked).",
            "default": true
          },
          "maxEvidencePosts": {
            "title": "Evidence posts per creator",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "How many evidence posts to attach.",
            "default": 3
          },
          "minCreatorScore": {
            "title": "Minimum creator score (0-100)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Exclude creators scoring below this. 0 = off.",
            "default": 0
          },
          "maxCandidates": {
            "title": "Maximum profiles analysed",
            "minimum": 0,
            "maximum": 3000,
            "type": "integer",
            "description": "Cap on public profiles fetched and analysed. 0 = automatic (3x maxCreators, at least 20), because qualification rejects a share of candidates. Profile seeds are always analysed in addition.",
            "default": 0
          },
          "expandSimilarProfiles": {
            "title": "Expand with similar profiles",
            "type": "boolean",
            "description": "When Top Content yields too few qualified creators, also analyse the \"Other similar profiles\" LinkedIn lists on qualified creators' public profiles (TOPIC, KEYWORD and HYBRID modes).",
            "default": true
          },
          "fetchMissingCommentCounts": {
            "title": "Fetch missing comment counts",
            "type": "boolean",
            "description": "If a profile card omits a post's comment count, read that post's public page to fill it in (max 5 posts per creator). Turn off for faster runs; affected creators are flagged COMMENT_COUNTS_INCOMPLETE.",
            "default": true
          },
          "debugMode": {
            "title": "Debug mode",
            "type": "boolean",
            "description": "Save every rejected candidate with its rejection reasons to the REJECTED_CANDIDATES key-value record. Rejected candidates are never charged.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify Proxy (datacenter) is used by default. Apify Residential is not supported - supply your own residential provider via Custom proxy URLs if you need one.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}