# Linktree Advanced Lead Scraper (Category & Subcategory) (`ahmed_jasarevic/linktree-advanced-lead-scraper`) Actor Advanced Linktree scraper that extracts profiles from category and subcategory directories, collects emails, social links, bio data, and profile metadata. Supports pagination, proxy rotation, and large-scale lead extraction from Linktree discovery pages. - **URL**: https://apify.com/ahmed\_jasarevic/linktree-advanced-lead-scraper.md - **Developed by:** [Ahmed Jasarevic](https://apify.com/ahmed_jasarevic) (community) - **Categories:** Lead generation, Social media, E-commerce - **Stats:** 6 total users, 5 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $5.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## 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 ## ๐ŸŒฟ Linktree & Bio Lead Discovery Scraper (Categories & Subcategories) **Discover and extract large-scale leads from Linktree, Beacons and other link-in-bio directories using categories and subcategories.** This tool is designed for **bulk lead discovery**, allowing you to start from curated categories or subcategories and automatically expand them into a structured list of real profiles containing emails, social links, and business information. ๐Ÿ‘‰ For direct profile extraction (single Linktree URL), use this companion Actor: [https://apify.com/ahmed_jasarevic/linktree-beacons-bio-email-scraper-extract-leads](https://apify.com/ahmed_jasarevic/linktree-beacons-bio-email-scraper-extract-leads) --- ### ๐Ÿš€ What this tool does Instead of manually searching for creators or businesses one by one, this Actor lets you: * ๐Ÿ“‚ Explore entire categories of link-in-bio profiles * ๐Ÿ”Ž Expand subcategories into full profile lists * ๐Ÿ“ˆ Automatically collect hundreds of profiles per category * ๐Ÿง  Discover hidden creators, brands, and businesses at scale It acts as a **discovery engine for link-in-bio ecosystems**. --- ### ๐ŸŽฏ Input options You can control the scraping flow using: #### ๐Ÿ“‚ Categories Scrape full top-level groups of profiles (e.g. โ€œattractionsโ€, โ€œfashionโ€, โ€œfitnessโ€). #### ๐Ÿ“ Subcategories Target more specific segments inside categories for refined lead discovery. #### ๐Ÿ”„ Pagination control Define how deep the scraper should go per category. --- ### ๐Ÿ“Š What you get Each discovered profile is expanded into structured lead data: * Username * Profile URL * Email addresses (if publicly available) * Social media links (Instagram, TikTok, YouTube, X, etc.) * External and affiliate links * Bio / description * Verification status * Scraped timestamp --- ### ๐Ÿ’ก Use cases * ๐ŸŒ Building large influencer databases * ๐Ÿ“ฃ Marketing outreach campaigns * ๐Ÿงฒ Lead generation for agencies and freelancers * ๐Ÿ“Š Market research on creator niches * ๐Ÿ’ผ Finding business contacts from public profiles * ๐Ÿš€ Scaling discovery of monetized online profiles --- ### โšก Key advantages * Built for **bulk discovery at scale** * Expands categories into full lead datasets automatically * Works across multiple link-in-bio ecosystems * Produces clean, structured, export-ready data * Ideal for growth, sales, and outreach workflows --- ### ๐Ÿ”— Recommended workflow 1. Use this Actor to **discover profiles via categories/subcategories** 2. Then pass individual profile URLs into the companion Actor for deeper extraction: [https://apify.com/ahmed_jasarevic/linktree-beacons-bio-email-scraper-extract-leads](https://apify.com/ahmed_jasarevic/linktree-beacons-bio-email-scraper-extract-leads) This gives you a **two-step lead system: discovery โ†’ enrichment** --- ### ๐Ÿง  Output example ```json { "username": "exampleuser", "sourceUrl": "https://linktr.ee/exampleuser", "emails": ["contact@example.com"], "socialLinks": [ { "type": "INSTAGRAM", "url": "https://instagram.com/exampleuser" } ], "regularLinks": [ { "title": "My Website", "url": "https://example.com" } ], "bio": "Creator sharing lifestyle content and business links.", "isVerified": true, "scrapedAt": "2026-05-20T12:00:00Z" } ```` *** ### ๐Ÿ”ฅ Perfect for - Agencies building large lead databases - Growth marketers scaling outreach lists - Affiliate marketers discovering monetized profiles - Researchers analyzing creator ecosystems - Sales teams finding public contact points # Actor input Schema ## `categories` (type: `array`): Select one or more main categories. ## `subCategories` (type: `array`): Select specific sub-categories. ## `maxPagesPerCategory` (type: `integer`): How deep the scraper will go inside each category/sub-category (1 page ~ 24 profiles). ## `maxConcurrency` (type: `integer`): Maximum number of pages processed simultaneously. ## `debugLog` (type: `boolean`): Turn on to see detailed logs and raw network payloads in the console. ## `proxyConfiguration` (type: `object`): It is highly recommended to use Apify Proxy to avoid getting rate-limited by Linktree. ## Actor input object example ```json { "categories": [ "business" ], "subCategories": [], "maxPagesPerCategory": 5, "maxConcurrency": 10, "debugLog": false, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `dataset` (type: `string`): Link to the default dataset containing the scraped Linktree and Bio leads. # 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 = { "categories": [ "business" ] }; // Run the Actor and wait for it to finish const run = await client.actor("ahmed_jasarevic/linktree-advanced-lead-scraper").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 = { "categories": ["business"] } # Run the Actor and wait for it to finish run = client.actor("ahmed_jasarevic/linktree-advanced-lead-scraper").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 '{ "categories": [ "business" ] }' | apify call ahmed_jasarevic/linktree-advanced-lead-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=ahmed_jasarevic/linktree-advanced-lead-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Linktree Advanced Lead Scraper (Category & Subcategory)", "description": "Advanced Linktree scraper that extracts profiles from category and subcategory directories, collects emails, social links, bio data, and profile metadata. Supports pagination, proxy rotation, and large-scale lead extraction from Linktree discovery pages.", "version": "1.0", "x-build-id": "Dc64BS5zSbHYs9Qph" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ahmed_jasarevic~linktree-advanced-lead-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ahmed_jasarevic-linktree-advanced-lead-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/ahmed_jasarevic~linktree-advanced-lead-scraper/runs": { "post": { "operationId": "runs-sync-ahmed_jasarevic-linktree-advanced-lead-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/ahmed_jasarevic~linktree-advanced-lead-scraper/run-sync": { "post": { "operationId": "run-sync-ahmed_jasarevic-linktree-advanced-lead-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": { "categories": { "title": "๐Ÿข Main Categories (Linktree)", "type": "array", "description": "Select one or more main categories.", "items": { "type": "string", "enum": [ "business", "creative", "education", "entertainment", "fashion-beauty", "food-beverage", "government-politics", "health-wellness", "non-profit", "other", "tech", "travel-tourism" ], "enumTitles": [ "๐Ÿข Business", "๐ŸŽจ Creative", "๐Ÿ“š Education", "๐Ÿคฉ Entertainment", "๐Ÿ‘— Fashion & Beauty", "๐Ÿ• Food & Beverage", "โš–๏ธ Government & Politics", "๐ŸŽ Health & Wellness", "๐Ÿ’— Non-Profit", "๐Ÿ˜Ž Other", "๐Ÿ–ฅ Tech", "โœˆ๏ธ Travel & Tourism" ] }, "default": [ "business" ] }, "subCategories": { "title": "๐Ÿ” Sub-categories", "type": "array", "description": "Select specific sub-categories.", "items": { "type": "string", "enum": [ "automobiles", "startup", "venture-capital", "real-estate", "public-relations", "weddings", "shopping-retail", "home-improvement-maintenance", "hr-recruiting", "marketing-advertising", "legal-services", "agency-consulting", "recreation", "financial-services", "digital-creator", "designer", "cosplay", "model", "visual-arts", "writer", "crafts", "influencer", "campus-organizations", "teacher", "schools-universities", "e-learning", "radio-podcasts", "actor", "dance-theatre", "sports", "music", "talent-management", "performance-art", "talent-agency", "comedy", "live-events", "gaming-esports", "film-tv", "tattoos-piercings", "nail-care", "jewelry", "shoes", "hair-care", "makeup-skincare", "clothing-accessories", "fragrances", "desserts", "bars-restaurants", "coffee-tea", "chef", "alcohol", "home-cooking", "groceries", "policy", "activism", "library", "countries-municipalities", "judiciary", "public-services", "emergency-services", "politicians-campaigns", "military-veterans", "law-enforcement", "spirituality", "nutrition", "cannabis", "healthcare", "life-coaching", "disaster-relief", "community-organization", "museums", "wildlife", "diversity-inclusion", "climate", "public-figure", "crowdfunding", "not-listed", "affiliate-marketing", "fan-club", "electronic-press-kit", "memes", "contests-giveaways", "portfolio", "religion", "pets", "personal", "edutech", "social-media", "hardware", "fintech", "saas", "mobile-app", "transportation", "attractions", "hotels-lodging" ], "enumTitles": [ "๐Ÿš— Automobiles", "๐Ÿš€ Startup", "๐Ÿ’ฐ Venture Capital", "๐Ÿ  Real Estate", "๐Ÿ“ข Public Relations", "๐Ÿ’ Weddings", "๐Ÿ›๏ธ Shopping & Retail", "๐Ÿ› ๏ธ Home Improvement & Maintenance", "๐Ÿ‘ฅ HR & Recruiting", "๐Ÿ“ˆ Marketing & Advertising", "โš–๏ธ Legal Services", "๐Ÿข Agency & Consulting", "๐ŸŽฎ Recreation", "๐Ÿ’ณ Financial Services", "๐ŸŽฅ Digital Creator", "๐ŸŽจ Designer", "๐ŸŽญ Cosplay", "๐Ÿ“ธ Model", "๐Ÿ–ผ Visual Arts", "โœ๏ธ Writer", "๐Ÿงต Crafts", "๐Ÿ“ฃ Influencer", "๐ŸŽ“ Campus Organizations", "๐Ÿ‘ฉโ€๐Ÿซ Teacher", "๐Ÿซ Schools & Universities", "๐Ÿ’ป E-learning", "๐Ÿ“ป Radio & Podcasts", "๐ŸŽฌ Actor", "๐Ÿ’ƒ Dance & Theatre", "๐Ÿ† Sports", "๐ŸŽต Music", "๐ŸŽฏ Talent Management", "๐ŸŽญ Performance Art", "๐Ÿข Talent Agency", "๐Ÿ˜‚ Comedy", "๐ŸŽค Live Events", "๐ŸŽฎ Gaming & Esports", "๐ŸŽฌ Film & TV", "๐Ÿ’‰ Tattoos & Piercings", "๐Ÿ’… Nail Care", "๐Ÿ’ Jewelry", "๐Ÿ‘Ÿ Shoes", "๐Ÿ’‡ Hair Care", "๐Ÿ’„ Makeup & Skincare", "๐Ÿ‘— Clothing & Accessories", "๐ŸŒธ Fragrances", "๐Ÿฐ Desserts", "๐Ÿฝ Bars & Restaurants", "โ˜• Coffee & Tea", "๐Ÿ‘จโ€๐Ÿณ Chef", "๐Ÿบ Alcohol", "๐Ÿณ Home Cooking", "๐Ÿ›’ Groceries", "๐Ÿ“œ Policy", "โœŠ Activism", "๐Ÿ“š Library", "๐ŸŒ Countries & Municipalities", "โš–๏ธ Judiciary", "๐Ÿ› Public Services", "๐Ÿšจ Emergency Services", "๐Ÿ—ณ Politicians & Campaigns", "๐Ÿช– Military & Veterans", "๐Ÿš“ Law Enforcement", "๐Ÿง˜ Spirituality", "๐Ÿฅ— Nutrition", "๐ŸŒฟ Cannabis", "๐Ÿฅ Healthcare", "๐Ÿง  Life Coaching", "๐Ÿš‘ Disaster Relief", "๐Ÿค Community Organization", "๐Ÿ› Museums", "๐Ÿพ Wildlife", "๐ŸŒˆ Diversity & Inclusion", "๐ŸŒ Climate", "๐Ÿ‘ค Public Figure", "๐Ÿ’ธ Crowdfunding", "๐Ÿ“ฆ Not Listed", "๐Ÿค Affiliate Marketing", "๐ŸŽ‰ Fan Club", "๐Ÿ“ฐ Electronic Press Kit", "๐Ÿ˜‚ Memes", "๐ŸŽ Contests & Giveaways", "๐Ÿ“ Portfolio", "๐Ÿ•Œ Religion", "๐Ÿถ Pets", "๐Ÿง Personal", "๐Ÿง  Edutech", "๐Ÿ“ฑ Social Media", "๐Ÿ–ฅ Hardware", "๐Ÿฆ Fintech", "โ˜๏ธ SaaS", "๐Ÿ“ฒ Mobile App", "๐Ÿš• Transportation", "๐ŸŽก Attractions", "๐Ÿจ Hotels & Lodging" ] }, "default": [] }, "maxPagesPerCategory": { "title": "๐Ÿ“„ Max pages per category", "minimum": 1, "type": "integer", "description": "How deep the scraper will go inside each category/sub-category (1 page ~ 24 profiles).", "default": 5 }, "maxConcurrency": { "title": "Max Concurrency", "type": "integer", "description": "Maximum number of pages processed simultaneously.", "default": 10 }, "debugLog": { "title": "๐Ÿž Enable Debug Logs", "type": "boolean", "description": "Turn on to see detailed logs and raw network payloads in the console.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "It is highly recommended to use Apify Proxy to avoid getting rate-limited by Linktree.", "default": { "useApifyProxy": 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 } } } } } } } } } } ```