# Linktree Profile & Contact Scraper - Emails, Phones, Socials (`elliotpadfield/linktree-profile-contact-scraper`) Actor Linktree scraper for lead generation and creator discovery. Extract emails, phone numbers, Instagram handles, social links, outbound buttons, profile metadata, account tier/country/active signals, commerce and affiliate signals, and related profiles from public Linktree URLs or usernames. - **URL**: https://apify.com/elliotpadfield/linktree-profile-contact-scraper.md - **Developed by:** [Elliot Padfield](https://apify.com/elliotpadfield) (community) - **Categories:** Automation, Lead generation, Social media - **Stats:** 1 total users, 0 monthly users, 71.4% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 linktree profiles 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 Profile & Contact Scraper - Emails, Phones, Socials & Links Scrape public Linktree profiles at scale and export structured contact, social, profile, and link-in-bio intelligence. Paste usernames or URLs, extract Linktree URLs from raw text or source pages, discover profiles by keyword, or turn a small seed list into a larger audience map with related-profile crawling. Use this Actor for influencer prospecting, creator discovery, music and booking outreach, agency lead lists, ecommerce and affiliate research, CRM enrichment, and scheduled monitoring of public Linktree pages. ### What can this Linktree scraper do? - Scrape one or many Linktree profiles by username, handle, slug, or full URL - Accept `profiles`, `urls`, `profileUrls`, `usernames`, and `handles` for easy API integration - Extract Linktree URLs from pasted text, CSV snippets, exported lists, HTML, and notes - Fetch public source pages or sitemap URLs and extract Linktree profile URLs from them - Discover profiles by keyword and optional location using search-based discovery - Expand seed profiles using Linktree related/trusted profile suggestions - Extract emails and phone numbers from visible profile text, buttons, metadata, `mailto:` links, and `tel:` links - Extract real outbound Instagram handles, not just the Linktree username - Extract typed social links such as TikTok, YouTube, Instagram, X, Facebook, LinkedIn, Spotify, Threads, Twitch, Snapchat, WhatsApp, Pinterest, Discord, Patreon, SoundCloud, and more - Export every profile button with title, URL, domain, Linktree type, thumbnail, position, lock status, and preview metadata - Return account signals such as verified, active, tier, country, created/updated dates, sensitive/password flags, commerce, affiliate, and pinned-link status - Filter before saving rows so you only pay for profiles that match your use case - Run without a browser for each profile, keeping runs fast and efficient - Always use Apify Residential Proxy for profile, source-page, and discovery requests ### Popular use cases | Use case | How to run it | |---|---| | Enrich a known creator list | Paste usernames or URLs into `profiles`, `urls`, or `usernames` | | Build an outreach list | Enable `requireEmail` or `requirePhone`, then export CSV or send results to a CRM | | Find Instagram creators | Use `requireInstagram` and `requiredPlatforms` | | Discover similar creators | Add seed profiles and enable `enableCrawling` | | Source ecommerce/affiliate leads | Use `requireCommerce`, `requireAffiliateContent`, or `linkDomains` | | Clean noisy source lists | Paste raw text into `bulkText` or fetch pages with `sourceUrls` | | Monitor a known market | Schedule the Actor with the same inputs and deduplicate by `slug` downstream | ### Input methods | Method | Fields | |---|---| | Direct profile scraping | `profiles`, `urls`, `profileUrls`, `usernames`, `handles` | | Raw pasted data | `bulkText` | | Public pages containing Linktree URLs | `sourceUrls` | | XML sitemaps or URL-list pages | `sitemapUrls` | | Keyword discovery | `searchKeywords`, `queries` | | Localized discovery | `searchKeywords` plus `location` | | Related-profile crawling | `enableCrawling`, `crawlDepth`, `maxProfiles` | ### What data do you get? | Data type | Fields | |---|---| | Identity | `slug`, `linktreeUrl`, `title`, `description`, `profilePicture` | | Contact info | `emails`, `phones`, `emailCount`, `phoneCount` | | Social graph | `instagram`, `socials`, `socialPlatforms`, `socialCount` | | Profile buttons | `links`, `linkDomains`, `linkTypes`, `linkCount` | | Account signals | `verified`, `active`, `country`, `tier`, `createdAt`, `updatedAt` | | Safety and locks | `hasSensitiveContent`, `hasPagePassword`, `pageLockType` | | Commercial signals | `hasCommerce`, `hasAffiliateContent`, `hasPinnedLinks` | | Crawling metadata | `relatedProfiles`, `relatedProfileCount`, `crawlDepth` | | Run provenance | `sourceType`, `sourceValue`, `observedAt` | Each item in `links` can include: | Link field | Description | |---|---| | `id` | Linktree button ID when exposed | | `title` | Button title | | `url` | Destination URL | | `domain` | Parsed destination domain | | `type` | Linktree button type, such as `CLASSIC` | | `thumbnail` | Button thumbnail or preview image | | `position` | Button position on the profile | | `locked` | Whether the button is locked when exposed | | `metaTitle`, `metaDescription` | Preview metadata from Linktree's payload | ### Example input #### Enrich known profiles ```json { "profiles": [ "garyvee", "https://linktr.ee/apify", "@examplecreator" ], "maxProfiles": 100, "includeLinks": true, "includeSocials": true, "includeEmails": true, "includePhones": true } ```` #### Expand from a seed list ```json { "profiles": ["garyvee"], "enableCrawling": true, "crawlDepth": 1, "maxProfiles": 250, "requireInstagram": true } ``` #### Build a contactable lead list ```json { "sourceUrls": ["https://example.com/creator-directory"], "requireEmail": true, "emailDomains": ["gmail.com", "outlook.com"], "excludeKeywords": ["fanpage", "archive"], "maxProfiles": 1000 } ``` #### Find commerce or affiliate creators ```json { "searchKeywords": ["beauty creator", "fashion influencer"], "location": "United States", "requireCommerce": true, "requiredPlatforms": ["INSTAGRAM", "TIKTOK"], "linkDomains": ["shopify.com", "amazon.com", "ltk.app"], "maxProfiles": 500 } ``` #### Extract Linktree URLs from raw text ```json { "bulkText": "Potential partners: https://linktr.ee/garyvee and linktr.ee/apify", "minLinks": 2, "activeOnly": true } ``` ### Output example ```json { "slug": "garyvee", "linktreeUrl": "https://linktr.ee/garyvee", "status": "ok", "title": "Gary Vaynerchuk", "description": null, "verified": true, "active": true, "country": null, "tier": "free", "hasCommerce": false, "hasAffiliateContent": false, "instagram": ["garyvee"], "socials": { "INSTAGRAM": "https://instagram.com/garyvee", "YOUTUBE": "https://www.youtube.com/user/GaryVaynerchuk", "X": "https://x.com/garyvee" }, "socialPlatforms": ["FACEBOOK", "INSTAGRAM", "LINKEDIN", "SOUNDCLOUD", "TWITCH", "X", "YOUTUBE"], "links": [ { "id": "10039912", "title": "iTunes", "url": "https://podcasts.apple.com/us/podcast/...", "domain": "podcasts.apple.com", "type": "CLASSIC", "thumbnail": "https://ugc.production.linktr.ee/...", "position": 1, "locked": null, "metaTitle": "The GaryVee Audio Experience - Podcast - Apple Podcasts", "metaDescription": "Listen to Gary Vaynerchuk..." } ], "linkDomains": ["open.spotify.com", "podcasts.apple.com", "soundcloud.com"], "linkTypes": ["CLASSIC"], "emails": [], "phones": ["+12129315731"], "linkCount": 11, "socialCount": 7, "emailCount": 0, "phoneCount": 1, "relatedProfiles": [ { "username": "sabrinacarpenter", "profileName": "Sabrina Carpenter" } ], "relatedProfileCount": 10, "sourceType": "direct", "sourceValue": "garyvee", "crawlDepth": 0, "observedAt": "2026-06-06T12:00:00.000Z" } ``` ### Search methods and filters | Capability | Supported | |---|---| | Username, handle, slug, or URL input | Yes | | API-friendly aliases | Yes | | Bulk text URL extraction | Yes | | Source page URL extraction | Yes | | Sitemap URL extraction | Yes | | Keyword discovery | Yes | | Optional location discovery | Yes | | Related-profile crawling | Yes | | Email extraction | Yes | | Phone extraction | Yes | | Real Instagram handle extraction | Yes | | Typed social platform extraction | Yes | | Button title, URL, type, thumbnail, and metadata | Yes | | Account tier, active, verified, and country signals | Yes | | Commerce and affiliate signals | Yes | | Required/excluded platform filters | Yes | | Required/excluded link-domain filters | Yes | | Required link-type filters | Yes | | Email-domain allowlist | Yes | | Required/excluded keyword filters | Yes | | Sensitive/password profile exclusions | Yes | | Output toggles for links, socials, emails, phones, and related profiles | Yes | ### Pricing This Actor uses predictable per-profile pricing. One saved dataset item is one public Linktree profile that passed your filters. For small tests, set `maxProfiles` to 10 or 25. For lead lists, use filters such as `requireEmail`, `requirePhone`, `requireInstagram`, `linkDomains`, `countryCodes`, or `includeKeywords` so the dataset only contains profiles you actually want. You are charged only for profiles saved to the dataset. Deleted, filtered, blocked, or empty profiles are not saved as dataset rows. ### Reliability notes The Actor fetches each public Linktree page and parses the server-rendered `__NEXT_DATA__` payload. It does not run a browser for every profile, so it is fast and efficient. Keyword discovery uses public search results and is best-effort. For deterministic runs, use direct profiles, bulk text, source URLs, sitemap URLs, or related-profile crawling from known seed profiles. Phone extraction is intentionally conservative. It prioritizes `tel:` links and phone-shaped values in visible profile/button text to avoid polluting lead lists with internal IDs. The Actor always uses Apify Residential Proxy for profile, source-page, and discovery requests. For larger jobs, set `maxConcurrency` between 20 and 50. For cautious runs, increase `requestDelayMs`. Run-level stats are saved to `RUN_STATS`, including successful profiles, contact counts, filtered profiles, crawl discoveries, blocked/not-found/deleted profiles, pushed rows, and charge-limit status. Because it runs on Apify, you also get scheduling, API access, datasets, webhooks, residential proxy infrastructure, and integrations without maintaining your own scraping stack. # Actor input Schema ## `profiles` (type: `array`): Linktree slugs, handles, or full profile URLs. Examples: garyvee, @garyvee, https://linktr.ee/garyvee. ## `urls` (type: `array`): Alias for Profiles. Useful for API clients that send a generic urls field. ## `profileUrls` (type: `array`): Alias for Profiles. Paste one or more Linktree profile URLs. ## `usernames` (type: `array`): Alias for Profiles. Paste bare Linktree usernames or handles. ## `handles` (type: `array`): Alias for Profiles. Accepts handles with or without @. ## `bulkText` (type: `string`): Paste raw text, CSV snippets, HTML, emails, or notes. The Actor extracts every linktr.ee/profile URL it can find. ## `sourceUrls` (type: `array`): Fetch these pages and extract Linktree profile URLs from the HTML. Useful for public directories, blog posts, exported landing pages, and saved lists. ## `sitemapUrls` (type: `array`): Alias for Source Pages. Paste XML sitemap URLs or any public URL that contains Linktree links. ## `enableCrawling` (type: `boolean`): Expand from seed profiles using Linktree's related/trusted profile graph. Seeds are processed first and maxProfiles remains the hard cap. ## `crawlDepth` (type: `integer`): Maximum related-profile hops from your seed profiles. 1 means scrape seeds plus directly related profiles. ## `searchKeywords` (type: `array`): Discover Linktree profiles via search using site:linktr.ee plus these keywords. Best for niche prospecting; direct profile inputs are more deterministic. ## `queries` (type: `array`): Alias for Keyword Discovery. Useful when calling the Actor from generic search workflows. ## `location` (type: `string`): Optional location appended to keyword discovery searches, such as London, New York, Austin, or Berlin. ## `maxProfiles` (type: `integer`): Maximum unique profiles to scrape after discovery and before output filters. ## `requireInstagram` (type: `boolean`): Save only profiles that link a real Instagram account. ## `requireEmail` (type: `boolean`): Save only profiles that expose at least one email address. ## `requirePhone` (type: `boolean`): Save only profiles where a phone number or tel: link is detected. ## `requiredPlatforms` (type: `array`): Save only profiles that link all selected platforms. ## `excludedPlatforms` (type: `array`): Drop profiles that link any selected platform. ## `verifiedOnly` (type: `boolean`): Save only Linktree profiles marked as verified. ## `activeOnly` (type: `boolean`): Drop profiles where Linktree marks the account as inactive. ## `countryCodes` (type: `array`): Save only profiles with one of these Linktree account country codes, such as US, GB, CA, AU, DE, FR. ## `tiers` (type: `array`): Save only profiles on these Linktree account tiers when exposed in the profile payload, such as free, paid, pro, premium. ## `excludeSensitive` (type: `boolean`): Drop profiles flagged by Linktree as sensitive content. ## `excludePasswordLocked` (type: `boolean`): Drop profiles that expose a page password lock signal. ## `requireCommerce` (type: `boolean`): Save only profiles with Linktree commerce/storefront items. ## `requireAffiliateContent` (type: `boolean`): Save only profiles where Linktree exposes affiliate-content signals. ## `minLinks` (type: `integer`): Save only profiles with at least this many outbound links. ## `maxLinks` (type: `integer`): Optional upper bound for outbound link count. Useful for avoiding directory-style or spammy profiles. ## `emailDomains` (type: `array`): If set, keep only emails ending in these domains and apply email filters after that allowlist. Examples: gmail.com, outlook.com, agency.com. ## `linkDomains` (type: `array`): Save only profiles linking at least one of these domains. Examples: instagram.com, tiktok.com, shopify.com, calendly.com, patreon.com. ## `excludeLinkDomains` (type: `array`): Drop profiles linking any of these domains. ## `linkTypes` (type: `array`): Save only profiles that contain at least one of these Linktree button/link types, such as CLASSIC, COMMERCE, MUSIC, VIDEO. ## `includeKeywords` (type: `array`): Save profiles where at least one keyword appears in the title, bio, social URLs, emails, or link titles/URLs. ## `excludeKeywords` (type: `array`): Drop profiles where any keyword appears in the title, bio, social URLs, emails, or link titles/URLs. ## `includeLinks` (type: `boolean`): Include the links array and linkDomains in saved dataset rows. ## `includeSocials` (type: `boolean`): Include instagram and socials fields in saved dataset rows. ## `includeEmails` (type: `boolean`): Include emails in saved dataset rows. Email filters still work when this is disabled. ## `includePhones` (type: `boolean`): Include detected phone numbers in saved dataset rows. Phone filters still work when this is disabled. ## `includeRelatedProfiles` (type: `boolean`): Include Linktree related/trusted profile suggestions in saved dataset rows. ## `maxLinksPerProfile` (type: `integer`): Maximum outbound links to store per profile. linkCount still reports the full parsed count. ## `maxConcurrency` (type: `integer`): Number of Linktree profiles to fetch in parallel. The Actor always uses Apify Residential Proxy for profile, source-page, and discovery requests. ## `requestDelayMs` (type: `integer`): Optional delay in milliseconds after each profile request. Keep at 0 for speed; increase for cautious runs. ## `maxRetries` (type: `integer`): Retries for transient HTTP, timeout, or proxy failures. ## Actor input object example ```json { "profiles": [ "garyvee" ], "enableCrawling": false, "crawlDepth": 1, "maxProfiles": 100, "requireInstagram": false, "requireEmail": false, "requirePhone": false, "verifiedOnly": false, "activeOnly": false, "excludeSensitive": false, "excludePasswordLocked": false, "requireCommerce": false, "requireAffiliateContent": false, "minLinks": 0, "includeLinks": true, "includeSocials": true, "includeEmails": true, "includePhones": true, "includeRelatedProfiles": true, "maxLinksPerProfile": 250, "maxConcurrency": 30, "requestDelayMs": 0, "maxRetries": 3 } ``` # Actor output Schema ## `results` (type: `string`): Public Linktree profiles with emails, phones, social links, Instagram handles, outbound buttons, account signals, related profiles, crawl metadata, and source metadata stored in the default dataset. # 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 = { "profiles": [ "garyvee" ], "crawlDepth": 1, "maxProfiles": 100, "includeLinks": true, "includeSocials": true, "includeEmails": true, "includePhones": true, "includeRelatedProfiles": true, "maxLinksPerProfile": 250, "maxConcurrency": 30, "requestDelayMs": 0, "maxRetries": 3 }; // Run the Actor and wait for it to finish const run = await client.actor("elliotpadfield/linktree-profile-contact-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 = { "profiles": ["garyvee"], "crawlDepth": 1, "maxProfiles": 100, "includeLinks": True, "includeSocials": True, "includeEmails": True, "includePhones": True, "includeRelatedProfiles": True, "maxLinksPerProfile": 250, "maxConcurrency": 30, "requestDelayMs": 0, "maxRetries": 3, } # Run the Actor and wait for it to finish run = client.actor("elliotpadfield/linktree-profile-contact-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 '{ "profiles": [ "garyvee" ], "crawlDepth": 1, "maxProfiles": 100, "includeLinks": true, "includeSocials": true, "includeEmails": true, "includePhones": true, "includeRelatedProfiles": true, "maxLinksPerProfile": 250, "maxConcurrency": 30, "requestDelayMs": 0, "maxRetries": 3 }' | apify call elliotpadfield/linktree-profile-contact-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=elliotpadfield/linktree-profile-contact-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Linktree Profile & Contact Scraper - Emails, Phones, Socials", "description": "Linktree scraper for lead generation and creator discovery. Extract emails, phone numbers, Instagram handles, social links, outbound buttons, profile metadata, account tier/country/active signals, commerce and affiliate signals, and related profiles from public Linktree URLs or usernames.", "version": "1.0", "x-build-id": "NYdwDoSsaznTzoXa5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/elliotpadfield~linktree-profile-contact-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-elliotpadfield-linktree-profile-contact-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/elliotpadfield~linktree-profile-contact-scraper/runs": { "post": { "operationId": "runs-sync-elliotpadfield-linktree-profile-contact-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/elliotpadfield~linktree-profile-contact-scraper/run-sync": { "post": { "operationId": "run-sync-elliotpadfield-linktree-profile-contact-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": { "profiles": { "title": "Profiles", "uniqueItems": true, "type": "array", "description": "Linktree slugs, handles, or full profile URLs. Examples: garyvee, @garyvee, https://linktr.ee/garyvee.", "items": { "type": "string" }, "default": [ "garyvee" ] }, "urls": { "title": "Profile URLs", "uniqueItems": true, "type": "array", "description": "Alias for Profiles. Useful for API clients that send a generic urls field.", "items": { "type": "string" } }, "profileUrls": { "title": "Profile URL Alias", "uniqueItems": true, "type": "array", "description": "Alias for Profiles. Paste one or more Linktree profile URLs.", "items": { "type": "string" } }, "usernames": { "title": "Usernames", "uniqueItems": true, "type": "array", "description": "Alias for Profiles. Paste bare Linktree usernames or handles.", "items": { "type": "string" } }, "handles": { "title": "Handles", "uniqueItems": true, "type": "array", "description": "Alias for Profiles. Accepts handles with or without @.", "items": { "type": "string" } }, "bulkText": { "title": "Bulk Text With Linktree URLs", "type": "string", "description": "Paste raw text, CSV snippets, HTML, emails, or notes. The Actor extracts every linktr.ee/profile URL it can find." }, "sourceUrls": { "title": "Source Pages Containing Linktree URLs", "uniqueItems": true, "type": "array", "description": "Fetch these pages and extract Linktree profile URLs from the HTML. Useful for public directories, blog posts, exported landing pages, and saved lists.", "items": { "type": "string" } }, "sitemapUrls": { "title": "Sitemap URLs", "uniqueItems": true, "type": "array", "description": "Alias for Source Pages. Paste XML sitemap URLs or any public URL that contains Linktree links.", "items": { "type": "string" } }, "enableCrawling": { "title": "Enable Related Profile Crawling", "type": "boolean", "description": "Expand from seed profiles using Linktree's related/trusted profile graph. Seeds are processed first and maxProfiles remains the hard cap.", "default": false }, "crawlDepth": { "title": "Crawl Depth", "minimum": 0, "maximum": 10, "type": "integer", "description": "Maximum related-profile hops from your seed profiles. 1 means scrape seeds plus directly related profiles.", "default": 1 }, "searchKeywords": { "title": "Keyword Discovery", "uniqueItems": true, "type": "array", "description": "Discover Linktree profiles via search using site:linktr.ee plus these keywords. Best for niche prospecting; direct profile inputs are more deterministic.", "items": { "type": "string" } }, "queries": { "title": "Keyword Query Alias", "uniqueItems": true, "type": "array", "description": "Alias for Keyword Discovery. Useful when calling the Actor from generic search workflows.", "items": { "type": "string" } }, "location": { "title": "Location For Discovery", "type": "string", "description": "Optional location appended to keyword discovery searches, such as London, New York, Austin, or Berlin." }, "maxProfiles": { "title": "Maximum Profiles", "minimum": 1, "maximum": 200000, "type": "integer", "description": "Maximum unique profiles to scrape after discovery and before output filters.", "default": 100 }, "requireInstagram": { "title": "Only Profiles With Instagram", "type": "boolean", "description": "Save only profiles that link a real Instagram account.", "default": false }, "requireEmail": { "title": "Only Profiles With Email", "type": "boolean", "description": "Save only profiles that expose at least one email address.", "default": false }, "requirePhone": { "title": "Only Profiles With Phone", "type": "boolean", "description": "Save only profiles where a phone number or tel: link is detected.", "default": false }, "requiredPlatforms": { "title": "Required Platforms", "uniqueItems": true, "type": "array", "description": "Save only profiles that link all selected platforms.", "items": { "type": "string", "enum": [ "INSTAGRAM", "TIKTOK", "YOUTUBE", "X", "FACEBOOK", "LINKEDIN", "SPOTIFY", "THREADS", "TWITCH", "SNAPCHAT", "WHATSAPP", "PINTEREST", "DISCORD", "PATREON", "SHOPIFY" ] } }, "excludedPlatforms": { "title": "Excluded Platforms", "uniqueItems": true, "type": "array", "description": "Drop profiles that link any selected platform.", "items": { "type": "string", "enum": [ "INSTAGRAM", "TIKTOK", "YOUTUBE", "X", "FACEBOOK", "LINKEDIN", "SPOTIFY", "THREADS", "TWITCH", "SNAPCHAT", "WHATSAPP", "PINTEREST", "DISCORD", "PATREON", "SHOPIFY" ] } }, "verifiedOnly": { "title": "Verified Profiles Only", "type": "boolean", "description": "Save only Linktree profiles marked as verified.", "default": false }, "activeOnly": { "title": "Active Profiles Only", "type": "boolean", "description": "Drop profiles where Linktree marks the account as inactive.", "default": false }, "countryCodes": { "title": "Country Codes", "uniqueItems": true, "type": "array", "description": "Save only profiles with one of these Linktree account country codes, such as US, GB, CA, AU, DE, FR.", "items": { "type": "string" } }, "tiers": { "title": "Account Tiers", "uniqueItems": true, "type": "array", "description": "Save only profiles on these Linktree account tiers when exposed in the profile payload, such as free, paid, pro, premium.", "items": { "type": "string" } }, "excludeSensitive": { "title": "Exclude Sensitive Profiles", "type": "boolean", "description": "Drop profiles flagged by Linktree as sensitive content.", "default": false }, "excludePasswordLocked": { "title": "Exclude Password Locked Profiles", "type": "boolean", "description": "Drop profiles that expose a page password lock signal.", "default": false }, "requireCommerce": { "title": "Only Profiles With Commerce", "type": "boolean", "description": "Save only profiles with Linktree commerce/storefront items.", "default": false }, "requireAffiliateContent": { "title": "Only Profiles With Affiliate Content", "type": "boolean", "description": "Save only profiles where Linktree exposes affiliate-content signals.", "default": false }, "minLinks": { "title": "Minimum Outbound Links", "minimum": 0, "type": "integer", "description": "Save only profiles with at least this many outbound links.", "default": 0 }, "maxLinks": { "title": "Maximum Outbound Links", "minimum": 0, "type": "integer", "description": "Optional upper bound for outbound link count. Useful for avoiding directory-style or spammy profiles." }, "emailDomains": { "title": "Email Domain Allowlist", "uniqueItems": true, "type": "array", "description": "If set, keep only emails ending in these domains and apply email filters after that allowlist. Examples: gmail.com, outlook.com, agency.com.", "items": { "type": "string" } }, "linkDomains": { "title": "Required Link Domains", "uniqueItems": true, "type": "array", "description": "Save only profiles linking at least one of these domains. Examples: instagram.com, tiktok.com, shopify.com, calendly.com, patreon.com.", "items": { "type": "string" } }, "excludeLinkDomains": { "title": "Excluded Link Domains", "uniqueItems": true, "type": "array", "description": "Drop profiles linking any of these domains.", "items": { "type": "string" } }, "linkTypes": { "title": "Required Link Types", "uniqueItems": true, "type": "array", "description": "Save only profiles that contain at least one of these Linktree button/link types, such as CLASSIC, COMMERCE, MUSIC, VIDEO.", "items": { "type": "string" } }, "includeKeywords": { "title": "Required Keywords", "uniqueItems": true, "type": "array", "description": "Save profiles where at least one keyword appears in the title, bio, social URLs, emails, or link titles/URLs.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Excluded Keywords", "uniqueItems": true, "type": "array", "description": "Drop profiles where any keyword appears in the title, bio, social URLs, emails, or link titles/URLs.", "items": { "type": "string" } }, "includeLinks": { "title": "Include Outbound Links", "type": "boolean", "description": "Include the links array and linkDomains in saved dataset rows.", "default": true }, "includeSocials": { "title": "Include Social Links", "type": "boolean", "description": "Include instagram and socials fields in saved dataset rows.", "default": true }, "includeEmails": { "title": "Include Emails", "type": "boolean", "description": "Include emails in saved dataset rows. Email filters still work when this is disabled.", "default": true }, "includePhones": { "title": "Include Phones", "type": "boolean", "description": "Include detected phone numbers in saved dataset rows. Phone filters still work when this is disabled.", "default": true }, "includeRelatedProfiles": { "title": "Include Related Profiles", "type": "boolean", "description": "Include Linktree related/trusted profile suggestions in saved dataset rows.", "default": true }, "maxLinksPerProfile": { "title": "Maximum Links Per Profile", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Maximum outbound links to store per profile. linkCount still reports the full parsed count.", "default": 250 }, "maxConcurrency": { "title": "Maximum Concurrency", "minimum": 1, "maximum": 100, "type": "integer", "description": "Number of Linktree profiles to fetch in parallel. The Actor always uses Apify Residential Proxy for profile, source-page, and discovery requests.", "default": 30 }, "requestDelayMs": { "title": "Per-Profile Delay", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Optional delay in milliseconds after each profile request. Keep at 0 for speed; increase for cautious runs.", "default": 0 }, "maxRetries": { "title": "Maximum Retries", "minimum": 0, "maximum": 8, "type": "integer", "description": "Retries for transient HTTP, timeout, or proxy failures.", "default": 3 } } }, "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 } } } } } } } } } } ```