# Public Company Leadership Team Feed (`convenient_yarn/public-company-leadership-team-feed`) Actor - **URL**: https://apify.com/convenient\_yarn/public-company-leadership-team-feed.md - **Developed by:** [Travis Berman](https://apify.com/convenient_yarn) (community) - **Categories:** Business, Developer tools, Lead generation - **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Public Company Leadership Team Feed Extract leadership, executive, founder, and board people from public company website pages into normalized rows. An opt-in change mode can compare recurring runs and emit only additions, removals, and title changes without breaking the existing snapshot output. ### Why this Actor Automation users often need a repeatable way to pull names and titles from public team/about/leadership pages without building custom site-specific scrapers every time. This Actor is a narrow, permission-respecting starting point for that recurring workflow. ### What it does - accepts a list of public HTTPS company/team page URLs; - fetches the pages with no login, no browser automation, and no private data access; - extracts people from JSON-LD when sites publish structured `Person` data; - adds a heuristic fallback for visible leadership cards and name/title pairs; - deduplicates rows by page URL, name, and title; - keeps `snapshot` as the default output mode for backward compatibility; - optionally stores a named roster baseline and emits `added`, `updated`, and `removed` rows in `changes` mode; - writes a `SUMMARY` record with row and change counts. ### Example input ```json { "urls": [ "https://www.williamsf1.com/team", "https://theorg.com/org/altimetrik/teams/leadership-team" ], "maxRows": 50, "maxPeoplePerPage": 15, "mode": "changes", "snapshotKey": "weekly-leadership-watch" } ```` The Store's prefilled input uses the same single public Kohler leadership page as the local smoke fixture. It is deliberately bounded to one HTTPS URL and the default `snapshot` mode, so a first run produces a current roster without requiring a saved baseline. Use `"mode": "snapshot"` (the default) to receive the complete current roster on every run. Use `"mode": "changes"` with a stable `snapshotKey` to persist the current roster and receive only deltas on later runs. The first changes-mode run reports the current people as `added` because no earlier baseline exists. ### Output Each row contains: - `pageUrl` - `pageTitle` - `personName` - `personTitle` - `sectionHint` - `sourceType` - `confidence` - `extractedAt` In `changes` mode, each row also includes `changeType`, `currentTitle`, and `previousTitle`. The `SUMMARY` key-value record reports current, previous, added, updated, removed, and total change counts. ### Safety Only use public pages you are allowed to access. The Actor rejects non-HTTPS URLs, credentials in URLs, localhost/private hosts, and custom ports. It does not bypass access controls. ### Status The snapshot-only version is live in the Apify Store. The backward-compatible change-detection upgrade is locally implemented and must pass publication review before any deploy. # Actor input Schema ## `urls` (type: `array`): One or more public HTTPS company/team page URLs. ## `maxRows` (type: `integer`): Hard cap on emitted rows across all input URLs. ## `maxPeoplePerPage` (type: `integer`): Hard cap on extracted rows per source page. ## `mode` (type: `string`): snapshot emits the current leadership roster and preserves existing behavior. changes compares against a stored prior run and emits only added, updated, or removed people. ## `snapshotKey` (type: `string`): Named key-value-store record used only in changes mode. Reuse the same name for the same monitored feed. ## Actor input object example ```json { "urls": [ "https://www.kohlercompany.com/who-we-are/leadership-team/" ], "maxRows": 100, "maxPeoplePerPage": 20, "mode": "snapshot", "snapshotKey": "public-company-leadership-team-feed:snapshot" } ``` # Actor output Schema ## `dataset` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("convenient_yarn/public-company-leadership-team-feed").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("convenient_yarn/public-company-leadership-team-feed").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call convenient_yarn/public-company-leadership-team-feed --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=convenient_yarn/public-company-leadership-team-feed", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Public Company Leadership Team Feed", "version": "0.1", "x-build-id": "9e5jxcqwQklhAffnB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/convenient_yarn~public-company-leadership-team-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-convenient_yarn-public-company-leadership-team-feed", "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/convenient_yarn~public-company-leadership-team-feed/runs": { "post": { "operationId": "runs-sync-convenient_yarn-public-company-leadership-team-feed", "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/convenient_yarn~public-company-leadership-team-feed/run-sync": { "post": { "operationId": "run-sync-convenient_yarn-public-company-leadership-team-feed", "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", "required": [ "urls" ], "properties": { "urls": { "title": "Public HTTPS page URLs", "minItems": 1, "maxItems": 20, "type": "array", "description": "One or more public HTTPS company/team page URLs.", "items": { "type": "string" }, "default": [ "https://www.kohlercompany.com/who-we-are/leadership-team/" ] }, "maxRows": { "title": "Maximum output rows", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard cap on emitted rows across all input URLs.", "default": 100 }, "maxPeoplePerPage": { "title": "Maximum people per page", "minimum": 1, "maximum": 200, "type": "integer", "description": "Hard cap on extracted rows per source page.", "default": 20 }, "mode": { "title": "Output mode", "enum": [ "snapshot", "changes" ], "type": "string", "description": "snapshot emits the current leadership roster and preserves existing behavior. changes compares against a stored prior run and emits only added, updated, or removed people.", "default": "snapshot" }, "snapshotKey": { "title": "Change baseline name", "pattern": "^[A-Za-z0-9._:-]+$", "minLength": 1, "maxLength": 120, "type": "string", "description": "Named key-value-store record used only in changes mode. Reuse the same name for the same monitored feed.", "default": "public-company-leadership-team-feed:snapshot" } } }, "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 } } } } } } } } } } ```