# LinkedIn Company Headcount Growth API (`uplifted_virtue/linkedin-company-headcount-growth`) Actor Use case: Satış ekipleri ve yatırım analistleri, hedef şirketlerin son 3-12 aydaki çalışan büyümesini, departman bazlı işe alım hızını ve lokasyon genişlemesini otomatik izleyerek erken büyüme sinyali yakalar. Hedef kullanıcı: B2B outbound ajansları, RevOps ekipleri, VC/PE analistleri ve r - **URL**: https://apify.com/uplifted\_virtue/linkedin-company-headcount-growth.md - **Developed by:** [Deniz Berk Polat](https://apify.com/uplifted_virtue) (community) - **Categories:** Jobs - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN 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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## LinkedIn Company Headcount Growth API 🚀 ### Ne Yapar? Yatırım yapmayı planladığınız o yükselen girişimin son 3 ayda sessiz sedasız %20 küçüldüğünü veya rakibinizin satış ekibini agresif bir şekilde ikiye katladığını anlamak için her sabah LinkedIn profillerinde manuel gezmekten, Excel tablolarında boğulmaktan bıktıysanız, bu API sizin için. LinkedIn Company Headcount Growth API, karmaşık veri madenciliği süreçlerini ve "acaba hesap kapatıldı mı?" endişelerini aradan çıkarır; size sadece stratejik kararlar almanız için gereken saf büyüme verisini sunar. Bir şirketin çalışan sayısındaki değişimleri, departman bazlı genişlemeleri ve tarihsel trendleri doğrudan veritabanınıza akıtır. --- ### Neden Bu API? (Acı Reçeteden Kurtulun) Şu an muhtemelen şunu yapıyorsunuz: Bir stajyer veya analist arkadaşımız, her hafta belirlenen 50-100 şirketin LinkedIn sayfasına tek tek giriyor, çalışan sayılarını bir yere not ediyor ve geçen ayla kıyaslıyor. **Bu yöntemin maliyeti:** * **Zaman Kaybı:** Şirket başına 5 dakika harcansa, 100 şirket için haftada 8 saatten fazla emek demek. * **Veri Kalitesi:** İnsan hatasına çok açık. Bir rakamın yanlış girilmesi tüm yatırım analizini çökertebilir. * **Ölçekleme Sorunu:** Takip etmek istediğiniz şirket sayısı 1000'e çıktığında bu işi yapmak imkansız hale gelir. **LinkedIn Company Headcount Growth API ile hayatınız nasıl değişiyor?** Bu API olmadan, proxy yönetimi, LinkedIn'in sürekli değişen arayüz bot korumaları ve veri normalleştirme gibi "mühendislik kabuslarıyla" uğraşmak zorundasınız. Biz tüm bu altyapı yükünü omuzlarınızdan alıyoruz. * **3 Saat Yerine 3 Saniye:** Haftalık manuel raporlama sürecinizi tamamen otomatize ederek saniyeler içinde güncel veriye ulaşırsınız. * **Kesintisiz Erişim:** IP engellemeleri veya "giriş yap" uyarılarıyla vakit kaybetmezsiniz. * **Stratejik Üstünlük:** Rakibinizin yeni bir pazara girmek için o bölgede işe alım yapmaya başladığını, onlar duyurmadan siz öğrenirsiniz. --- ### Quick Start (2 Dakikada Yayındasınız) Geliştirici dostu olmak bizim için sadece bir slogan değil. Aşağıdaki `curl` komutunu terminalinize yapıştırarak saniyeler içinde ilk verinizi alabilirsiniz. #### İlk Sorgunuzu Atın: ```bash curl -X POST https://example.com/v1/query \ -H "Content-Type: application/json" \ -d '{ "url": "https://www.linkedin.com/company/google/", "limit": 1 }' ```` #### Beklenen Çıktı (JSON): ```json { "request_id": "req-20260504-001", "items": [ { "title": "Google", "url": "https://www.linkedin.com/company/google/", "source": "headcount_tracker" } ], "source_timestamp": "2026-05-04T12:00:00+00:00", "errors": [] } ``` *İpucu: `request_id` değerini ileride destek talepleriniz için not etmeyi unutmayın!* *** ### Endpoint Detayları Sistemimiz basitlik üzerine kuruldu. Karmaşık parametre yığınları arasında kaybolmanıza izin vermiyoruz. | Metot | Path | Ne Alır? | Ne Döndürür? | Ne Zaman Kullanılır? | | :--- | :--- | :--- | :--- | :--- | | **POST** | `/v1/query` | Şirket URL ve Limit | Şirket büyüme metrikleri ve timestamp | Ana veriyi çekmek istediğinizde. | | **GET** | `/v1/health` | - | Servis durumu (UP/DOWN) | Sistemin ayakta olup olmadığını otomatize kontrol etmek için. | | **GET** | `/v1/metrics` | - | Gecikme ve cache istatistikleri | Performans optimizasyonu yapmak istediğinizde. | *** ### Çözüm Odaklı Hata Kodları Hata aldığınızda "Nerede yanlış yaptım?" diye düşünmenizi istemiyoruz. Hata mesajlarımız size ne yapmanız gerektiğini söyler. - **`INVALID_URL`**: Gönderdiğiniz LinkedIn URL'si hatalı veya eksik. Lütfen URL'nin `https://www.linkedin.com/company/` formatında olduğundan emin olun. - **`RATE_LIMITED`**: Çok fazla istek gönderdiniz ve sunucularımız biraz nefes almak istiyor. 1 saniye bekleyip tekrar deneyin. Eğer binlerce sorguyu aynı anda atacaksanız, kurumsal planımızdaki `--batch` özelliğini inceleyin. - **`NOT_FOUND`**: Belirttiğiniz şirket LinkedIn üzerinde bulunamadı veya sayfası gizli. Şirketin LinkedIn üzerinde halka açık bir profili olduğunu kontrol edin. - **`INSUFFICIENT_CREDITS`**: Mevcut paketinizdeki limitleri doldurdunuz. Bir üst pakete geçerek veya yeni ayın başlamasını bekleyerek devam edebilirsiniz. *** ### Kullanım Alanları (Gerçek Dünyadan Senaryolar) 1. **Venture Capital & Yatırım:** Erken aşama girişimlerin çalışan sayısındaki istikrarlı artış, genellikle bir sonraki büyük yatırım turunun habercisidir. Kimse duyurmadan "hiring" sinyallerini yakalayın. 2. **Rakip Analizi:** Rakibinizin Product Management ekibi küçülürken Sales ekibi büyüyorsa, stratejilerini "ürün geliştirmeden" "pazara açılmaya" çevirdiklerini anlayabilirsiniz. 3. **Satış & İş Geliştirme:** Büyümekte olan şirketler, genellikle yeni araçlara ve hizmetlere en çok ihtiyaç duyan şirketlerdir. "Sıcak" potansiyel müşterileri büyüme verisine göre filtreleyin. *** ### Şeffaf Fiyatlandırma Gizli maliyetler veya "satış ekibimizle görüşün" zorunluluğu yok. İhtiyacınıza göre seçin: - **Ücretsiz Plan:** Ayda 100 istek. API'yi denemek ve küçük çaplı projeler başlatmak için idealdir. (0₺) - **Developer Planı:** Ayda 5.000 istek. Ciddi analizler ve orta ölçekli otomasyonlar için birebir. ($19.99/ay) - **Business Planı:** Ayda 50.000 istek. Yatırım fonları ve büyük ölçekli pazar araştırma şirketleri için tasarlandı. ($89.99/ay) - **Enterprise:** Limitsiz erişim ve özel destek. Büyük düşünüyorsanız bize bir e-posta atın, size özel bir yapı kuralım. *** ### Geliştirici Notu 💡 Dostum, biz de geliştiriciyiz ve dokümantasyon okumanın ne kadar sıkıcı olabileceğini biliyoruz. Eğer takıldığın bir yer olursa veya "Şu özellik de olsa harika olurdu" dersen, çekinme. Amacımız senin veriyle olan savaşını bitirip, sadece inşa etmene odaklanmanı sağlamak. **Hadi, ilk sorgunu at ve büyüme sinyallerini yakalamaya başla!** # Actor input Schema ## `query` (type: `string`): Company name or keyword used to discover LinkedIn company page URLs. ## `region` (type: `string`): Region scope for search context. ## `limit` (type: `integer`): Maximum number of LinkedIn company URLs to process. ## Actor input object example ```json { "region": "global", "limit": 25 } ``` # 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("uplifted_virtue/linkedin-company-headcount-growth").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("uplifted_virtue/linkedin-company-headcount-growth").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 uplifted_virtue/linkedin-company-headcount-growth --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=uplifted_virtue/linkedin-company-headcount-growth", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "LinkedIn Company Headcount Growth API", "description": "Use case: Satış ekipleri ve yatırım analistleri, hedef şirketlerin son 3-12 aydaki çalışan büyümesini, departman bazlı işe alım hızını ve lokasyon genişlemesini otomatik izleyerek erken büyüme sinyali yakalar. Hedef kullanıcı: B2B outbound ajansları, RevOps ekipleri, VC/PE analistleri ve r", "version": "0.1", "x-build-id": "xOdoRq6DPgXIjddh0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/uplifted_virtue~linkedin-company-headcount-growth/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-uplifted_virtue-linkedin-company-headcount-growth", "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/uplifted_virtue~linkedin-company-headcount-growth/runs": { "post": { "operationId": "runs-sync-uplifted_virtue-linkedin-company-headcount-growth", "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/uplifted_virtue~linkedin-company-headcount-growth/run-sync": { "post": { "operationId": "run-sync-uplifted_virtue-linkedin-company-headcount-growth", "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": [ "query" ], "properties": { "query": { "title": "Company query", "minLength": 3, "type": "string", "description": "Company name or keyword used to discover LinkedIn company page URLs." }, "region": { "title": "Region", "type": "string", "description": "Region scope for search context.", "default": "global" }, "limit": { "title": "Limit", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of LinkedIn company URLs to process.", "default": 25 } } }, "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 } } } } } } } } } } ```