# Linktree Scraper: Profiles, Emails and the Creator Directory (`alexmorain/linktree-scraper`) Actor

Scrape Linktree profiles: emails, phones, WhatsApp, every link, socials, products, country and plan. Or discover creators by category in Linktree's public directory of ~380,000 profiles, with free email, country and link-type filters. New and changed profile watch.

- **URL**: https://apify.com/alexmorain/linktree-scraper.md
- **Developed by:** [Alexis Morain](https://apify.com/alexmorain) (community)
- **Categories:** Lead generation, Social media, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 94.4% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.75 / 1,000 profiles

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does Linktree Scraper do?

Linktree Scraper reads **[Linktree](https://linktr.ee) profiles** and returns one row per profile: emails, phone numbers, WhatsApp, every link with its group, social accounts, products with prices, the owner's country, time zone, plan and account creation date.

It does two jobs:

1. **Scrape the profiles you already have.** Paste `linktr.ee/...` URLs or usernames, from Instagram bios, TikTok or a spreadsheet.
2. **Discover creators you don't have yet.** Linktree publishes a [profile directory](https://linktr.ee/discover/profile-directory) of about **380,000 profiles** in 12 categories and 95 subcategories (real estate, fitness, musicians, marketing, restaurants...). The actor walks it page by page to the end and reads every profile it lists. Other Linktree scrapers need you to bring the list of usernames.

Plain HTTP requests, no browser, no login.

#### Filters you don't pay for

Keep only the profiles that matter to you: **with an email**, **with an email or a phone**, **from some countries**, or **with links of a given type** (a shop, a booking page, a newsletter, a payment link, a membership, a WhatsApp chat...). A profile the actor reads and your filters drop is **not charged**.

Measured on a sample of the directory on 3 November 2026: about **1 profile in 5 shows an email** address and 1 in 4 a phone number or a WhatsApp link. About 4 in 10 owners set no country.

### Why use Linktree Scraper?

- **Influencer and creator outreach.** Pull the "fitness", "beauty" or "musicians" part of the directory, keep the profiles with an email, and get their Instagram, TikTok and YouTube in the same row.
- **B2B lead generation.** Real estate agents, coaches, restaurants, consultants and agencies put their Calendly, WhatsApp and contact email on their Linktree. Filter on `booking` or `messaging` links to find people who take appointments.
- **Sales intelligence.** `plan` and `isPaidPlan` tell you who pays for Linktree, `trackingPixels` who runs Meta or TikTok ads, `products` who sells, `linkCategories` which tools they use (Shopify, Substack, Patreon, Stan, Gumroad...).
- **Monitoring.** Schedule a run in **New profiles only** mode to get only the profiles added to a directory list since the last run, or in **New or changed** mode to get the profiles whose links, emails or bio changed, with the list of added and removed links.
- **Pipelines.** Export to JSON, CSV or Excel, Google Sheets, Make, Zapier or n8n, call it from the API, and receive a webhook when the run ends.

### What data can Linktree Scraper extract?

| Field | Example | Description |
|---|---|---|
| `username`, `url` | `selenagomez`, `https://linktr.ee/selenagomez` | The profile |
| `status` | `ok` | `ok`, or for a profile you asked for that could not be delivered: `not_found`, `blocked` (suspended by Linktree) or `unavailable`. Those rows are free |
| `displayName`, `bio`, `avatarUrl` | `Selena Gomez` | Name, bio and picture shown on the page |
| `emails` | `["booking@example.com"]` | From mailto links, link titles and the bio |
| `phones`, `whatsapp` | `["+33612345678"]` | From tel:, sms: and WhatsApp links, in international form |
| `socials` | `{"instagram": "https://instagram.com/...", "tiktok": "..."}` | One URL per network, from the social icons and the links |
| `links` | `[{"title": "Shop", "url": "...", "group": "Merch", "gate": null, "categories": ["shop"]}]` | Every link in page order, with the collection it sits in and whether it is age, password or NFT gated |
| `linkCount`, `groups`, `domains` | `58`, `["In The Dark"]`, `["rarebeauty.com"]` | Summary of the links |
| `linkCategories` | `{"music": 11, "shop": 1}` | Links and social icons per family: shop, booking, newsletter, payment, membership, music, podcast, messaging, form |
| `products` | `[{"title": "...", "price": 23.0, "currency": "USD"}]` | Products shown on the page |
| `country`, `timezone` | `US`, `America/Los_Angeles` | Set by the owner on the account |
| `categories` | `["music"]` | Verticals Linktree assigns to the profile |
| `plan`, `isPaidPlan` | `pro`, `true` | Linktree plan |
| `createdAt`, `updatedAt` | `2020-01-24T10:15:25Z` | Account creation and last update |
| `trackingPixels` | `{"facebookPixelId": "1234567890"}` | Google Analytics, Meta and TikTok pixel ids set on the page |
| `isVerified`, `badges`, `hasAffiliateLinks`, `hasSensitiveContent`, `isPasswordProtected` | | Flags of the page |
| `source` | `directory:fitness` | `input`, or the directory list the profile came from |
| `changes` | `{"status": "changed", "addedLinks": ["https://..."]}` | In **New or changed** monitoring mode only |

### How to scrape Linktree

1. Click **Try for free**.
2. Paste profiles into **Linktree profiles**, one per line, or pick **Directory categories** or **Directory subcategories** to discover creators.
3. Optionally tick **Only profiles with an email**, or set **Countries** and **Link types**.
4. Set **Max profiles**: it is also your cost cap.
5. Press **Start**, then download the dataset as JSON, CSV or Excel.

### How much will it cost to scrape Linktree?

You pay per profile delivered, plus a small start fee per run. Prices fall with your Apify plan, from **$1.50 per 1,000 profiles** on the free plan to **$0.75 per 1,000 at the Gold plan**. The start fee is $0.002 per GB of memory, with a minimum of one event: $0.002 with the default 512 MB.

Profiles dropped by your filters, profiles unchanged since the last run in monitoring mode, and the status rows of profiles that do not exist are **free**. So 1,000 profiles with an email cost $1.50, even if the actor had to read 5,000 to find them.

**Max profiles** and the spending limit you set on a run stop it at the amount you choose.

### Input

See the **Input** tab for every option. The main ones:

| Field | What it does |
|---|---|
| `profiles` | Profile URLs or usernames, one per line |
| `categories`, `subcategories` | Directory lists to walk. `all` is the whole directory, about 21,100 pages |
| `maxProfiles` | Profiles delivered, all sources together. `0` = no limit. Default 100 |
| `maxPagesPerDirectory`, `startPage` | How many directory pages to read per list (18 profiles each), and where to start. Use `startPage` to split a big list across runs |
| `onlyWithEmail`, `onlyWithContact` | Keep profiles with an email, or with an email or a phone |
| `countries` | Two-letter codes such as `US`, `GB`, `FR` |
| `linkCategories` | Keep profiles with at least one link of these types |
| `monitorMode` | `off`, `new` (only profiles never delivered by a previous run of the same input) or `changed` (new profiles plus profiles whose links, emails, phones, socials, bio or products changed) |
| `registryKey` | Name of the monitoring memory, to keep it when you change the input |
| `webhookUrl` | Receives a JSON summary when the run ends |
| `maxConcurrency` | Parallel connections, one proxy IP each. Default 16 |

### Output

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel. A profile from the real estate directory, shortened (the full row has every field of the table above):

```json
{
  "username": "Agarravilla",
  "url": "https://linktr.ee/Agarravilla",
  "status": "ok",
  "displayName": "@Agarravilla",
  "emails": ["agarravilla@gmail.com"],
  "phones": ["+6281227417676"],
  "whatsapp": ["+6281227417676"],
  "socials": {
    "instagram": "https://instagram.com/agarravilla",
    "tiktok": "https://tiktok.com/@agarravilla"
  },
  "links": [
    {"title": "Whatsapp", "url": "https://wa.me/+6281227417676", "type": "CLASSIC", "position": 0, "group": null,
     "thumbnail": "https://assets.production.linktr.ee/tabler-icons/outline/brand-whatsapp.svg", "gate": null,
     "categories": ["messaging"]}
  ],
  "linkCount": 1,
  "linkCategories": {"messaging": 2},
  "domains": ["wa.me"],
  "country": null,
  "plan": "free",
  "isPaidPlan": false,
  "createdAt": "2021-10-22T11:16:23Z",
  "source": "directory:real-estate",
  "changes": null,
  "scrapedAt": "2026-11-04T00:40:20Z"
}
```

A profile you asked for that does not exist:

```json
{"username": "thisdoesnotexist", "url": "https://linktr.ee/thisdoesnotexist", "status": "not_found", "source": "input", "scrapedAt": "2026-11-04T00:44:31Z"}
```

#### Run it from your code

Python:

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("alexmorain/linktree-scraper").call(run_input={
    "subcategories": ["fitness"],
    "onlyWithEmail": True,
    "countries": ["US", "GB"],
    "maxProfiles": 500,
})
for profile in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(profile["username"], profile["emails"], profile["socials"].get("instagram"))
```

JavaScript:

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('alexmorain/linktree-scraper').call({
    profiles: ['https://linktr.ee/selenagomez', 'garyvee'],
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.map((p) => [p.username, p.linkCount]));
```

cURL:

```bash
curl -X POST "https://api.apify.com/v2/acts/alexmorain~linktree-scraper/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"categories": ["business"], "linkCategories": ["booking"], "maxProfiles": 100}'
```

### Tips

- **Speed.** About 4 profiles per second with the default 16 connections on Apify's datacenter proxy: 2,000 profiles took 8.5 minutes on 4 November 2026. Linktree limits each IP to about one page per second, so more connections means more speed, up to 32.
- **Split the whole directory.** `all` has about 21,100 pages. Run several actors with different `startPage` values, or walk the categories one by one.
- **Deleted accounts.** 6 to 8 in 100 profiles listed in the directory no longer exist (measured on 2,500 profiles). The actor skips them for free and counts them in the log.
- **Filters that keep almost nothing.** If your filters drop nearly every profile of a list (say a rare country on the whole directory), the run stops after about 10,000 free reads with a message that says so. Pick a narrower subcategory or loosen the filters.

### FAQ

#### Does it find emails that are not on the page?

No. It reads what the profile owner published: mailto links, emails in link titles and in the bio. It does not guess or buy addresses, so every email comes from the owner.

#### Can I monitor a list of profiles for changes?

Yes. Put the profiles in **Linktree profiles**, set **Monitoring** to **New or changed**, and schedule the run. The first run delivers everything. Later runs deliver only the profiles whose links, emails, phones, socials, bio or products changed, with a `changes` field listing what was added and removed. Unchanged profiles are free.

#### What about suspended or private pages?

A suspended profile you asked for comes back with `status: blocked`, a missing one with `status: not_found`, both free. A password-protected page is returned with `isPasswordProtected: true`.

#### Is it legal to scrape Linktree?

The actor reads public pages that anyone can open without an account. Personal data such as emails and phone numbers is protected by laws like the GDPR and the CCPA: collect it only with a legitimate reason, and check with your lawyer if you are unsure. See Apify's [guide to web scraping legality](https://blog.apify.com/is-web-scraping-legal/).

#### Something is missing or broken

Open an issue on the **Issues** tab with the run link. Fixes usually ship within a day.

### Guide and use cases

Use cases for outbound and automation, the output fields, pricing and common questions are on the [Linktree Scraper page](https://alexis.morain.fr/en/scrapers/linktree-scraper/) of my site. The [Lead generation family page](https://alexis.morain.fr/en/scrapers/families/lead-generation/) puts it side by side with the other scrapers of the same family.

# Actor input Schema

## `profiles` (type: `array`):

Profiles to scrape, one per line: <code>https://linktr.ee/selenagomez</code>, <code>linktr.ee/garyvee</code>, <code>@garyvee</code> or the bare username. A profile that does not exist, is suspended or cannot be reached comes back as a free row with <code>status</code> set to <code>not_found</code>, <code>blocked</code> or <code>unavailable</code>. Can be combined with the directory below.

## `categories` (type: `array`):

Find new creators in Linktree's public profile directory (about 380,000 profiles, 18 per page). <code>all</code> walks the whole directory. Use <b>Max profiles</b> and <b>Max directory pages</b> to size the run.

## `subcategories` (type: `array`):

Narrower directory lists, such as <code>real-estate</code>, <code>marketing-advertising</code>, <code>fitness</code> or <code>musicians</code>.

## `maxProfiles` (type: `integer`):

Stop after this many profiles delivered (and charged). Filtered-out profiles do not count. <code>0</code> = no limit.

## `maxPagesPerDirectory` (type: `integer`):

Directory pages read per category or subcategory, 18 profiles per page. The whole <code>all</code> directory is about 21,100 pages.

## `startPage` (type: `integer`):

Skip the first pages of each directory list, to split a big list across several runs.

## `onlyWithEmail` (type: `boolean`):

Keep only profiles where an email address was found. About 1 profile in 5 in the directory has one.

## `onlyWithContact` (type: `boolean`):

Keep only profiles with an email, a phone number or a WhatsApp link.

## `countries` (type: `array`):

Two-letter country codes such as <code>US</code>, <code>GB</code>, <code>FR</code>. Keeps profiles whose owner set one of these countries. About 4 profiles in 10 set no country and are left out by this filter.

## `linkCategories` (type: `array`):

Keep only profiles with at least one link of these types, to find creators who sell, take bookings or run a newsletter.

## `monitorMode` (type: `string`):

For scheduled runs. <code>new</code> delivers only profiles never delivered by an earlier run with the same input. <code>changed</code> also delivers profiles whose links, emails, phones, socials, bio or products changed, with a <code>changes</code> field listing added and removed links and emails. Unchanged profiles are read but not charged.

## `registryKey` (type: `string`):

Optional name for the monitoring memory. By default it is derived from the input, so changing the input starts a fresh one. Set a key to keep it across input changes.

## `webhookUrl` (type: `string`):

Called with a JSON summary (run id, dataset id, counts, status) when the run ends.

## `maxConcurrency` (type: `integer`):

Each connection uses its own proxy IP and reads about one page per second. Without a proxy the actor uses one connection.

## `proxyConfiguration` (type: `object`):

Apify datacenter proxy by default. Linktree limits each IP to about one page per second.

## Actor input object example

```json
{
  "profiles": [
    "https://linktr.ee/selenagomez",
    "garyvee"
  ],
  "maxProfiles": 10,
  "maxPagesPerDirectory": 50,
  "startPage": 1,
  "onlyWithEmail": false,
  "onlyWithContact": false,
  "monitorMode": "off",
  "maxConcurrency": 16,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `profiles` (type: `string`):

One row per profile: contacts, links, socials, plan

## `dataset` (type: `string`):

Every profile with all fields

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "profiles": [
        "https://linktr.ee/selenagomez",
        "garyvee"
    ],
    "maxProfiles": 10,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("alexmorain/linktree-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "profiles": [
        "https://linktr.ee/selenagomez",
        "garyvee",
    ],
    "maxProfiles": 10,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("alexmorain/linktree-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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": [
    "https://linktr.ee/selenagomez",
    "garyvee"
  ],
  "maxProfiles": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call alexmorain/linktree-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,alexmorain/linktree-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/9qw8fdM3APsSUUaHm/builds/hBheC9q4bgb3kPkxF/openapi.json
