# Linktree Leads - linktr.ee Profiles, Emails & Links (`igolaizola/linktree-leads`) Actor Find linktr.ee profiles for lead generation and extract bios, URLs, social links, images, emails, phone numbers, and link counts for creator research and outreach. - **URL**: https://apify.com/igolaizola/linktree-leads.md - **Developed by:** [Iñigo Garcia Olaizola](https://apify.com/igolaizola) (community) - **Categories:** Lead generation, Social media, SEO tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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/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 ## Linktree Leads — linktr.ee Profiles, Contacts & Social URLs ### 🤖 What does Linktree Leads do? **Linktree Leads** finds public **linktr.ee** profiles and extracts structured profile data, outbound links, social links, images, emails, and phone numbers. Use it to build lead generation lists from Linktree profiles for creator research, influencer discovery, brand monitoring, and contact enrichment. It has two discovery modes: - **Category mode** browses Linktree's public profile directory by category and subcategory. This is the default mode and is usually better for obtaining more results. - **Query mode** uses search with custom keywords. This is better when you need very specific profiles, niches, names, locations, or phrases. It can extract: - **Profile details** — username, title, bio, profile URL, images, verification status, location, and timestamps when available - **Link buttons** — title, destination URL, type, thumbnail, position, active status, and detailed link metadata - **Social links** — social platform, URL, and position - **Contact data** — public emails and phone numbers found in profile text and links - **Counts** — total regular links and social links per profile **Great for:** lead generation, creator discovery, influencer outreach, public contact enrichment, niche research, brand monitoring, and building prospect lists from linktr.ee profiles. > SEO keywords: **Linktree leads**, **linktr.ee scraper**, **scrape Linktree profiles**, **Linktree link extractor**, **Linktree email finder**, **Linktree lead generation**, **Apify actor**. ### 💡 Why collect Linktree leads? - 🎯 **Find creators and brands** — discover public linktr.ee profiles matching a keyword, niche, location, or profession. - 📬 **Enrich outreach lists** — collect public websites, social accounts, emails, and phone numbers from one profile page. - 🔎 **Research audiences and competitors** — compare how creators structure offers, content links, and social presence. - 🧭 **Map link ecosystems** — turn Linktree pages into clean lead generation datasets of destination URLs and social channels. ### 🚀 Quick Start 1. **Add the actor** – Open **Linktree Leads** in Apify Store. 2. **Configure inputs** – Choose `category` for directory discovery, or set `query` for specific search discovery. 3. **Run the actor** – Click **Run** or trigger it from the Apify API. 4. **Download results** – Export JSON, CSV, Excel, or Parquet from the **Dataset** tab. ### 📝 Input Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `maxItems` | Integer | Yes | Maximum number of linktr.ee profiles to collect for lead generation. Use `0` for unlimited. Default `100`. | | `category` | String | No | Linktree profile directory category to browse when `query` is empty, such as `"all/all"`, `"business/all"`, `"entertainment/music"`, or `"tech/saas"`. This mode is best for collecting more results. Default `"all/all"`. | | `query` | String | No | Keyword or phrase used for search mode, such as `"musician"`, `"fitness coach"`, or `"restaurant Austin"`. When `query` is not empty, the actor uses query mode and ignores `category`. | **Category mode: broad directory discovery** ```json { "maxItems": 100, "category": "all/all" } ```` **Category mode: focused directory discovery** ```json { "maxItems": 100, "category": "entertainment/music" } ``` **Query mode: specific search discovery** ```json { "maxItems": 50, "query": "musician Austin" } ``` ### 📊 Output / Results Each dataset item represents one public linktr.ee profile. **Field reference:** - **id** *(string)* — Linktree profile ID when available, otherwise a profile identifier. - **url** *(string)* — normalized linktr.ee profile URL. - **username** *(string)* — Linktree username. - **title** *(string)* — profile title or display name. - **description** *(string)* — profile bio or description. - **searchTitle** *(string)* — discovery result title. - **searchSnippet** *(string)* — discovery result snippet. - **category** *(string)* — Linktree directory category when discovered from category mode. - **subCategory** *(string)* — Linktree directory subcategory when discovered from category mode. - **profileImage** *(string)* — profile image URL. - **thumbnailImage** *(string)* — thumbnail image URL when available. - **isVerified** *(boolean)* — whether the profile is marked verified. - **location** *(string)* — public location or country when available. - **createdAt** *(string)* — profile creation timestamp when available. - **updatedAt** *(string)* — profile update timestamp when available. - **emails** *(array)* — public email addresses found in the profile data. - **phones** *(array)* — public phone numbers found in the profile data. - **linkCount** *(integer)* — number of extracted Linktree buttons. - **socialLinkCount** *(integer)* — number of extracted social links. - **links** *(array)* — outbound Linktree button data. - **socialLinks** *(array)* — social platform links. - **metadata** *(object)* — additional public profile metadata for advanced analysis. **Example output** ```json { "id": "17528217", "url": "https://linktr.ee/jasonlamson", "username": "jasonlamson", "title": "Jason Lamson | Musician Official: Instagram, Facebook | Linktree", "description": "Singer - Songwriter - Story Teller Savannah,GA->Key West,FL->Naples,FL", "searchTitle": "Jason Lamson | Musician Official: Instagram, Facebook | Linktree", "searchSnippet": "Jason Lamson | Musician - Singer - Songwriter - Story Teller...", "category": "Entertainment", "subCategory": "Music", "profileImage": "https://linktr.ee/og/image/jasonlamson.jpg", "thumbnailImage": "https://linktr.ee/og/image/jasonlamson.jpg", "isVerified": false, "location": "US", "createdAt": "2021-07-24T15:30:06Z", "updatedAt": "2026-03-17T19:11:08Z", "emails": ["jlamsonmusic@gmail.com"], "phones": [], "linkCount": 7, "socialLinkCount": 7, "links": [ { "id": "103434884", "title": "Welcome to the Show", "type": "HEADER", "isActive": true, "position": 1 } ], "socialLinks": [ { "type": "FACEBOOK", "platform": "FACEBOOK", "url": "https://www.facebook.com/jlamsonmusic/" } ], "metadata": { "props": { "pageProps": { "account": "..." } } } } ``` ### 🧭 Tips / Common Recipes - **Browse Linktree's directory:** set `category` to a category/subcategory value, such as `"business/all"`, `"fashion-beauty/makeup-skincare"`, or `"travel-tourism/hotels-lodging"`. - **Build a large lead list:** keep `category` set to `"all/all"` or choose a broad `Category > All` value. - **Find very specific profiles:** set `query` to a role, topic, name, or location, such as `"musician Austin"` or `"wedding photographer Miami"`. - **Keep exports small:** use dataset views or CSV column selection when you only need usernames, URLs, links, emails, and phone numbers. ### ⚙️ Best Practices - Set a realistic `maxItems` value first, then increase it after checking result quality. - If `query` is not empty, the actor uses search mode and ignores `category`. - If `query` is empty, the actor uses Linktree directory pagination with `category`. - Some profiles may be deleted, private, unavailable, or missing optional fields. The actor keeps working and saves what it can extract from available profiles. - Contact fields only include publicly visible emails and phone numbers detected in the profile data. ### ⚖️ Legal & Ethical Considerations - Respect Linktree's Terms of Service and robots rules. - Collect only public data and avoid excessive request volumes. - Handle personal data, including emails and phone numbers, responsibly and in compliance with privacy laws such as GDPR and CCPA. - Use scraped data for legitimate research, outreach, analytics, or interoperability purposes. - When publishing insights, attribute sources appropriately and avoid misleading representation. - This Actor is an independent tool and is **not** affiliated with, endorsed by, or sponsored by Linktree. All trademarks are the property of their respective owners. ### ❓ FAQ **Can I scrape Linktree profiles without a keyword?** Yes. Leave `query` empty and keep `category` set to `"all/all"` for broad directory discovery. **Can I use this for lead generation?** Yes. The dataset is designed for lead generation workflows: profile URLs, destination links, social links, emails, phone numbers, and profile context are returned in one row per linktr.ee profile. **Does the actor extract the links inside each Linktree profile?** Yes. It returns regular profile buttons in `links` and social profile URLs in `socialLinks`. **Can it find emails and phone numbers?** Yes, when they are publicly visible in the profile data, linked text, or destination text available on the Linktree page. **Why do some profiles have empty fields?** Some Linktree profiles do not publish every field, and some discovered URLs may be stale or unavailable. **Can I export the data to CSV or Excel?** Yes. Download the dataset from Apify in JSON, CSV, Excel, XML, RSS, or Parquet formats. ### 🛟 Support Need a custom field or export? Open an issue or contact me at https://igolaizola.com/#contact # Actor input Schema ## `maxItems` (type: `integer`): Maximum number of linktr.ee profiles to collect for lead generation. Use 0 for unlimited. ## `category` (type: `string`): Linktree profile directory category to browse when Query is empty. Category mode is best for collecting more lead generation results. ## `query` (type: `string`): Specific keyword or phrase to search for linktr.ee profiles. When Query is not empty, query mode is used and Category is ignored. ## Actor input object example ```json { "maxItems": 100, "category": "all/all", "query": "" } ``` # Actor output Schema ## `results` (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 = { "maxItems": 100, "category": "all/all", "query": "" }; // Run the Actor and wait for it to finish const run = await client.actor("igolaizola/linktree-leads").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 = { "maxItems": 100, "category": "all/all", "query": "", } # Run the Actor and wait for it to finish run = client.actor("igolaizola/linktree-leads").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 '{ "maxItems": 100, "category": "all/all", "query": "" }' | apify call igolaizola/linktree-leads --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=igolaizola/linktree-leads", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Linktree Leads - linktr.ee Profiles, Emails & Links", "description": "Find linktr.ee profiles for lead generation and extract bios, URLs, social links, images, emails, phone numbers, and link counts for creator research and outreach.", "version": "0.0", "x-build-id": "tK2AvFtNl9klydCCy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/igolaizola~linktree-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-igolaizola-linktree-leads", "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/igolaizola~linktree-leads/runs": { "post": { "operationId": "runs-sync-igolaizola-linktree-leads", "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/igolaizola~linktree-leads/run-sync": { "post": { "operationId": "run-sync-igolaizola-linktree-leads", "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": [ "maxItems" ], "properties": { "maxItems": { "title": "Max Items", "minimum": 0, "type": "integer", "description": "Maximum number of linktr.ee profiles to collect for lead generation. Use 0 for unlimited.", "default": 100 }, "category": { "title": "Category", "enum": [ "all/all", "business/all", "business/automobiles", "business/startup", "business/venture-capital", "business/real-estate", "business/public-relations", "business/weddings", "business/shopping-retail", "business/home-improvement-maintenance", "business/hr-recruiting", "business/marketing-advertising", "business/legal-services", "business/agency-consulting", "business/recreation", "business/financial-services", "creative/all", "creative/digital-creator", "creative/designer", "creative/cosplay", "creative/model", "creative/visual-arts", "creative/writer", "creative/crafts", "creative/influencer", "education/all", "education/campus-organizations", "education/teacher", "education/schools-universities", "education/e-learning", "entertainment/all", "entertainment/radio-podcasts", "entertainment/actor", "entertainment/dance-theatre", "entertainment/sports", "entertainment/music", "entertainment/talent-management", "entertainment/performance-art", "entertainment/talent-agency", "entertainment/comedy", "entertainment/live-events", "entertainment/gaming-esports", "entertainment/film-tv", "fashion-beauty/all", "fashion-beauty/tattoos-piercings", "fashion-beauty/nail-care", "fashion-beauty/jewelry", "fashion-beauty/shoes", "fashion-beauty/hair-care", "fashion-beauty/makeup-skincare", "fashion-beauty/clothing-accessories", "fashion-beauty/fragrances", "food-beverage/all", "food-beverage/desserts", "food-beverage/bars-restaurants", "food-beverage/coffee-tea", "food-beverage/chef", "food-beverage/alcohol", "food-beverage/home-cooking", "food-beverage/groceries", "government-politics/all", "government-politics/policy", "government-politics/activism", "government-politics/library", "government-politics/countries-municipalities", "government-politics/judiciary", "government-politics/public-services", "government-politics/emergency-services", "government-politics/politicians-campaigns", "government-politics/military-veterans", "government-politics/law-enforcement", "health-wellness/all", "health-wellness/spirituality", "health-wellness/nutrition", "health-wellness/cannabis", "health-wellness/healthcare", "health-wellness/life-coaching", "non-profit/all", "non-profit/disaster-relief", "non-profit/community-organization", "non-profit/museums", "non-profit/wildlife", "non-profit/diversity-inclusion", "non-profit/climate", "other/all", "other/public-figure", "other/crowdfunding", "other/not-listed", "other/affiliate-marketing", "other/fan-club", "other/electronic-press-kit", "other/memes", "other/contests-giveaways", "other/portfolio", "other/religion", "other/pets", "other/personal", "tech/all", "tech/edutech", "tech/social-media", "tech/hardware", "tech/fintech", "tech/saas", "tech/mobile-app", "travel-tourism/all", "travel-tourism/transportation", "travel-tourism/attractions", "travel-tourism/hotels-lodging" ], "type": "string", "description": "Linktree profile directory category to browse when Query is empty. Category mode is best for collecting more lead generation results.", "default": "all/all" }, "query": { "title": "Query", "type": "string", "description": "Specific keyword or phrase to search for linktr.ee profiles. When Query is not empty, query mode is used and Category is ignored.", "default": "" } } }, "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 } } } } } } } } } } ```