{ "openapi": "3.0.1", "info": { "title": "Linktree Scraper: Find Profiles by Sector & Keyword", "description": "Find Linktree profiles by sector (fashion, weddings, real estate, 100+ sections) and get bios, social links, websites, public emails and phones. No login needed.", "version": "0.1", "x-build-id": "9DPf5LnvMP662MIfj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/runtime~linktree-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-runtime-linktree-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/runtime~linktree-scraper/runs": { "post": { "operationId": "runs-sync-runtime-linktree-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/runtime~linktree-scraper/run-sync": { "post": { "operationId": "run-sync-runtime-linktree-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": { "sectors": { "title": "Sectors", "type": "array", "description": "Ready-made sector bundles. Most read Linktree's official profile directory; Pop-up stores has no directory section, so it uses web search (a proxy is recommended).", "items": { "type": "string", "enum": [ "fashion-brands", "pop-up-stores", "fashion-beauty", "health-wellness", "food-drink", "travel-tourism", "music", "arts-entertainment", "sports", "ecommerce", "real-estate", "education-coaching", "tech-business", "creators-media" ], "enumTitles": [ "Fashion brands (priority)", "Pop-up stores (priority)", "Fashion & beauty", "Health & wellness", "Food & drink", "Travel & tourism", "Music", "Arts & entertainment", "Sports", "E-commerce & shops", "Real estate", "Education & coaching", "Tech & business", "Creators & media" ] } }, "directorySections": { "title": "Directory sections (fine-grained)", "type": "array", "description": "Pick exact sections of Linktree's profile directory: 12 categories and ~95 sub-sectors such as weddings, real estate, makeup & skincare, bars & restaurants or nail care. About 20 profiles per page. Can be combined with the sector bundles.", "items": { "type": "string", "enum": [ "c/business", "c/creative", "c/education", "c/entertainment", "c/fashion-beauty", "c/food-beverage", "c/government-politics", "c/health-wellness", "c/non-profit", "c/other", "c/tech", "c/travel-tourism", "s/automobiles", "s/startup", "s/venture-capital", "s/real-estate", "s/public-relations", "s/weddings", "s/shopping-retail", "s/home-improvement-maintenance", "s/hr-recruiting", "s/marketing-advertising", "s/legal-services", "s/agency-consulting", "s/recreation", "s/financial-services", "s/digital-creator", "s/designer", "s/cosplay", "s/model", "s/visual-arts", "s/writer", "s/crafts", "s/influencer", "s/campus-organizations", "s/teacher", "s/schools-universities", "s/e-learning", "s/radio-podcasts", "s/actor", "s/dance-theatre", "s/sports", "s/music", "s/talent-management", "s/performance-art", "s/talent-agency", "s/comedy", "s/live-events", "s/gaming-esports", "s/film-tv", "s/tattoos-piercings", "s/nail-care", "s/jewelry", "s/shoes", "s/hair-care", "s/makeup-skincare", "s/clothing-accessories", "s/fragrances", "s/desserts", "s/bars-restaurants", "s/coffee-tea", "s/chef", "s/alcohol", "s/home-cooking", "s/groceries", "s/policy", "s/activism", "s/library", "s/countries-municipalities", "s/judiciary", "s/public-services", "s/emergency-services", "s/politicians-campaigns", "s/military-veterans", "s/law-enforcement", "s/spirituality", "s/nutrition", "s/cannabis", "s/healthcare", "s/life-coaching", "s/disaster-relief", "s/community-organization", "s/museums", "s/wildlife", "s/diversity-inclusion", "s/climate", "s/public-figure", "s/crowdfunding", "s/not-listed", "s/affiliate-marketing", "s/fan-club", "s/electronic-press-kit", "s/memes", "s/contests-giveaways", "s/portfolio", "s/religion", "s/pets", "s/personal", "s/edutech", "s/social-media", "s/hardware", "s/fintech", "s/saas", "s/mobile-app", "s/transportation", "s/attractions", "s/hotels-lodging" ], "enumTitles": [ "Business (category)", "Creative (category)", "Education (category)", "Entertainment (category)", "Fashion beauty (category)", "Food beverage (category)", "Government politics (category)", "Health wellness (category)", "Non profit (category)", "Other (category)", "Tech (category)", "Travel tourism (category)", "Automobiles (sub-sector)", "Startup (sub-sector)", "Venture capital (sub-sector)", "Real estate (sub-sector)", "Public relations (sub-sector)", "Weddings (sub-sector)", "Shopping retail (sub-sector)", "Home improvement maintenance (sub-sector)", "Hr recruiting (sub-sector)", "Marketing advertising (sub-sector)", "Legal services (sub-sector)", "Agency consulting (sub-sector)", "Recreation (sub-sector)", "Financial services (sub-sector)", "Digital creator (sub-sector)", "Designer (sub-sector)", "Cosplay (sub-sector)", "Model (sub-sector)", "Visual arts (sub-sector)", "Writer (sub-sector)", "Crafts (sub-sector)", "Influencer (sub-sector)", "Campus organizations (sub-sector)", "Teacher (sub-sector)", "Schools universities (sub-sector)", "E learning (sub-sector)", "Radio podcasts (sub-sector)", "Actor (sub-sector)", "Dance theatre (sub-sector)", "Sports (sub-sector)", "Music (sub-sector)", "Talent management (sub-sector)", "Performance art (sub-sector)", "Talent agency (sub-sector)", "Comedy (sub-sector)", "Live events (sub-sector)", "Gaming esports (sub-sector)", "Film tv (sub-sector)", "Tattoos piercings (sub-sector)", "Nail care (sub-sector)", "Jewelry (sub-sector)", "Shoes (sub-sector)", "Hair care (sub-sector)", "Makeup skincare (sub-sector)", "Clothing accessories (sub-sector)", "Fragrances (sub-sector)", "Desserts (sub-sector)", "Bars restaurants (sub-sector)", "Coffee tea (sub-sector)", "Chef (sub-sector)", "Alcohol (sub-sector)", "Home cooking (sub-sector)", "Groceries (sub-sector)", "Policy (sub-sector)", "Activism (sub-sector)", "Library (sub-sector)", "Countries municipalities (sub-sector)", "Judiciary (sub-sector)", "Public services (sub-sector)", "Emergency services (sub-sector)", "Politicians campaigns (sub-sector)", "Military veterans (sub-sector)", "Law enforcement (sub-sector)", "Spirituality (sub-sector)", "Nutrition (sub-sector)", "Cannabis (sub-sector)", "Healthcare (sub-sector)", "Life coaching (sub-sector)", "Disaster relief (sub-sector)", "Community organization (sub-sector)", "Museums (sub-sector)", "Wildlife (sub-sector)", "Diversity inclusion (sub-sector)", "Climate (sub-sector)", "Public figure (sub-sector)", "Crowdfunding (sub-sector)", "Not listed (sub-sector)", "Affiliate marketing (sub-sector)", "Fan club (sub-sector)", "Electronic press kit (sub-sector)", "Memes (sub-sector)", "Contests giveaways (sub-sector)", "Portfolio (sub-sector)", "Religion (sub-sector)", "Pets (sub-sector)", "Personal (sub-sector)", "Edutech (sub-sector)", "Social media (sub-sector)", "Hardware (sub-sector)", "Fintech (sub-sector)", "Saas (sub-sector)", "Mobile app (sub-sector)", "Transportation (sub-sector)", "Attractions (sub-sector)", "Hotels lodging (sub-sector)" ] } }, "directoryStartPage": { "title": "Directory start page", "minimum": 1, "maximum": 50000, "type": "integer", "description": "First directory page to read in each section. Raise it to get new profiles on later runs (each page holds ~20 profiles).", "default": 1 }, "keywords": { "title": "Custom keywords", "type": "array", "description": "Your own niche terms, one per line, e.g. wedding photographer, vegan bakery, crossfit coach. These are found through web search (Linktree has no search), then each profile must contain the term in its bio, title or link titles.", "items": { "type": "string" } }, "locations": { "title": "Cities or countries (search)", "type": "array", "description": "Optional places for the keyword search, e.g. Paris, Lyon, Brazil (adds web-search queries; the directory itself has no location). To keep only one country use the country filter below.", "items": { "type": "string" } }, "profileUrls": { "title": "Known profiles (optional)", "type": "array", "description": "Linktree URLs or usernames to scrape directly, e.g. https://linktr.ee/selenagomez. Also used as starting points when related profiles are followed.", "items": { "type": "string" } }, "scrapeProfiles": { "title": "Scrape profile details", "type": "boolean", "description": "On: open every profile and extract bio, links, socials, emails, phones. Off: only return the discovered profile URLs (fastest, no sector verification).", "default": true }, "maxProfiles": { "title": "Max profiles", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum profiles saved to the dataset.", "default": 50 }, "maxProfilesToScan": { "title": "Max profiles to scan", "minimum": 10, "maximum": 20000, "type": "integer", "description": "Safety limit on how many profiles are opened while looking for matches. Strict filters (country, email) reject most profiles, so the Actor keeps reading directory pages until it has enough matches or reaches this limit. Default: 25x Max profiles, between 300 and 5000." }, "requireSectorMatch": { "title": "Keep only profiles that match the sector", "type": "boolean", "description": "For profiles found by web search: drop those whose Linktree category, bio, title or link titles do not match your sector or keyword. Directory profiles are already in their section.", "default": true }, "countries": { "title": "Only these countries", "type": "array", "description": "Optional ISO country codes from the profile settings, e.g. FR, US, BR. Most profiles do not declare a country, so this filter rejects most profiles and raises the scan needed (for a city or country, prefer the Cities field). Profiles without a country are dropped.", "items": { "type": "string" } }, "onlyWithEmail": { "title": "Only profiles with a public email", "type": "boolean", "description": "Keep profiles that publish an email address in their bio or a mailto link.", "default": false }, "onlyBrands": { "title": "Only brands and businesses", "type": "boolean", "description": "Keep profiles that look like a business rather than an individual creator: an own website, a business email or a store platform (Shopify, Etsy...). This is a heuristic based on the profile's links, not a Linktree label.", "default": false }, "excludeAdult": { "title": "Exclude adult content", "type": "boolean", "description": "Skip profiles flagged sensitive or linking to adult subscription sites.", "default": true }, "expandRelated": { "title": "Also follow related profiles", "type": "boolean", "description": "Open the ~45 profiles Linktree lists as related on each page. Related profiles are often off-topic, so most are filtered out; costs more requests.", "default": false }, "maxExpansionDepth": { "title": "Related profile depth", "minimum": 1, "maximum": 3, "type": "integer", "description": "How many hops of related profiles to follow.", "default": 1 }, "keywordsPerSector": { "title": "Search keywords per sector", "minimum": 1, "maximum": 6, "type": "integer", "description": "How many keywords of each sector preset are searched. More keywords find more profiles but take longer.", "default": 3 }, "maxQueries": { "title": "Max search queries", "minimum": 1, "maximum": 200, "type": "integer", "description": "Hard cap on search queries (sector keywords x locations).", "default": 30 }, "searchPagesPerQuery": { "title": "Result pages per query", "minimum": 1, "maximum": 3, "type": "integer", "description": "Each page returns up to ~25 profiles; deeper pages mostly repeat.", "default": 2 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Recommended for keyword and city search: the search engine rate-limits repeated queries from one IP. Directory discovery works without it." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }