String docs
Site integrations

Linktree

Linktree link-in-bio profiles: display name, bio, avatar, verification, and every link and social icon on the page, each with its target's platform and handle.

Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.

  • Site: linktree
  • Version: 1.0.0
  • Reads from: linktr.ee
ActionDescriptionListed price
profileRead Linktree profiles by username: display name, bio, avatar, verification, account dates, and every social icon and link block, each with its cleaned URL, title, Linktree type, and the target's platform and handle.Billed per request at your plan's rates

profile

Read Linktree profiles by username: display name, bio, avatar, verification, account dates, and every social icon and link block, each with its cleaned URL, title, Linktree type, and the target's platform and handle.

POST https://request.usestring.ai/v1/integrations/linktree/profile

Input

Unknown fields are rejected.

FieldTypeDescription
profilesstring[] | nullRequired. Linktree usernames such as garyvee, or linktr.ee/<username> URLs. At least 1 entry.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
usernamestring—
urlstring—
idintegerLinktree's account id.
displayNamestring | nullThe page title the owner set, such as their name.
biostring | null—
avatarUrlstring | null—
verifiedboolean | nullWhether Linktree shows its verified badge on the profile.
createdAtstring | nullWhen the account was created, RFC 3339.
updatedAtstring | nullWhen the account was last changed, RFC 3339.
linksobject[]Every social icon, then every link block in page order. role is social for an icon and link for a block; kind is Linktree's block type (CLASSIC, COMMERCE_PRODUCT, ...) or icon name (INSTAGRAM, X, ...)
links[].urlstringThe link target, unwrapped from tracking redirects, with utm_* and click-id parameters removed.
links[].rawUrlstringThe link as the page has it.
links[].textstring | nullThe anchor text or link block title.
links[].kindstring | nullThe page's own type for the link, such as a link-in-bio block type or social icon name.
links[].sectionstring | nullThe title of the group or section the page puts the link under, when it has one.
links[].evidencestringHow the link was found: embedded_state, jsonld_sameAs or rel_me are the profile's own identity claims; anchor or json_url may be citations.
links[].rolestringsocial, link, contact (mailto: or tel:) or feed.
links[].platformstringThe target's platform, such as instagram, linkedin or youtube; website for any other host.
links[].handlestring | nullThe account the target names on its platform, when the URL's shape gives one.
links[].positionintegerOrder on the page from 0; earlier links are usually the more important.
droppedobjectLinks left out, such as share buttons, for debugging.
dropped.ownSiteintegerLinks back into the page's own site.
dropped.shareintegerShare buttons that open a platform's composer.
dropped.chromeintegerLinks the platform puts on every profile.

Example

curl https://request.usestring.ai/v1/integrations/linktree/profile \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profiles": ["garyvee"]
  }'

data starts with these rows:

[
  {
    "username": "garyvee",
    "url": "https://linktr.ee/garyvee",
    "id": 2339372,
    "displayName": "Gary Vaynerchuk",
    "bio": null,
    "avatarUrl": "https://ugc.production.linktr.ee/2dO9iKa7R9ijJ8402nHq_961961328ed1a3de55d5d083e8dd6793",
    "verified": true,
    "createdAt": "2019-05-15T23:53:28Z",
    "updatedAt": "2026-08-31T07:48:49Z",
    "links": [
      {
        "url": "https://www.facebook.com/gary",
        "rawUrl": "https://www.facebook.com/gary",
        "text": null,
        "kind": "FACEBOOK",
        "section": null,
        "evidence": "embedded_state",
        "role": "social",
        "platform": "facebook",
        "handle": "gary",
        "position": 0
      },
      {
        "url": "https://instagram.com/garyvee",
        "rawUrl": "https://instagram.com/garyvee",
        "text": null,
        "kind": "INSTAGRAM",
        "section": null,
        "evidence": "embedded_state",
        "role": "social",
        "platform": "instagram",
        "handle": "garyvee",
        "position": 1
      },
      {
        "url": "https://www.youtube.com/user/GaryVaynerchuk",
        "rawUrl": "https://www.youtube.com/user/GaryVaynerchuk",
        "text": null,
        "kind": "YOUTUBE",
        "section": null,
        "evidence": "embedded_state",
        "role": "social",
        "platform": "youtube",
        "handle": "GaryVaynerchuk",
        "position": 2
      },
      {
        "url": "https://soundcloud.com/garyvee/tracks",
        "rawUrl": "https://soundcloud.com/garyvee/tracks",
        "text": null,
        "kind": "SOUNDCLOUD",
        "section": null,
        "evidence": "embedded_state",
        "role": "social",
        "platform": "soundcloud",
        "handle": "garyvee",
        "position": 3
      },
      {
        "url": "https://www.linkedin.com/in/garyvaynerchuk/",
        "rawUrl": "https://www.linkedin.com/in/garyvaynerchuk/",
        "text": null,
        "kind": "LINKEDIN",
        "section": null,
        "evidence": "embedded_state",
        "role": "social",
        "platform": "linkedin",
        "handle": "garyvaynerchuk",
        "position": 4
      },
      {
        "url": "https://www.twitch.tv/garyvee",
        "rawUrl": "https://www.twitch.tv/garyvee",
        "text": null,
        "kind": "TWITCH",
        "section": null,
        "evidence": "embedded_state",
        "role": "social",
        "platform": "twitch",
        "handle": "garyvee",
        "position": 5
      },
      {
        "url": "https://x.com/garyvee",
        "rawUrl": "https://x.com/garyvee",
        "text": null,
        "kind": "X",
        "section": null,
        "evidence": "embedded_state",
        "role": "social",
        "platform": "x",
        "handle": "garyvee",
        "position": 6
      },
      {
        "url": "https://podcasts.apple.com/us/podcast/the-garyvee-audio-experience/id928159684",
        "rawUrl": "https://podcasts.apple.com/us/podcast/the-garyvee-audio-experience/id928159684?utm_medium=social&utm_source=linktree&utm_campaign=itunes",
        "text": "iTunes",
        "kind": "CLASSIC",
        "section": null,
        "evidence": "embedded_state",
        "role": "link",
        "platform": "website",
        "handle": null,
        "position": 7
      },
      {
        "url": "https://open.spotify.com/show/6SZVsPIxPfVs6aavqM1peY",
        "rawUrl": "https://open.spotify.com/show/6SZVsPIxPfVs6aavqM1peY?si=TpS2fY3KSJKWzOocDc4jUA&utm_medium=social&utm_source=linktree&utm_campaign=spotify",
        "text": "Spotify",
        "kind": "CLASSIC",
        "section": null,
        "evidence": "embedded_state",
        "role": "link",
        "platform": "spotify",
        "handle": "6SZVsPIxPfVs6aavqM1peY",
        "position": 8
      },
      {
        "url": "https://www.stitcher.com/podcast/the-askgaryvee-show",
        "rawUrl": "https://www.stitcher.com/podcast/the-askgaryvee-show?utm_medium=social&utm_source=linktree&utm_campaign=stitcher",
        "text": "Stitcher",
        "kind": "CLASSIC",
        "section": null,
        "evidence": "embedded_state",
        "role": "link",
        "platform": "website",
        "handle": null,
        "position": 9
      },
      {
        "url": "https://overcast.fm/itunes928159684/the-garyvee-audio-experience",
        "rawUrl": "https://overcast.fm/itunes928159684/the-garyvee-audio-experience?utm_medium=social&utm_source=linktree&utm_campaign=overcast",
        "text": "Overcast",
        "kind": "CLASSIC",
        "section": null,
        "evidence": "embedded_state",
        "role": "link",
        "platform": "website",
        "handle": null,
        "position": 10
      },
      {
        "url": "https://www.iheart.com/podcast/263-the-askgaryvee-show-27754057/",
        "rawUrl": "https://www.iheart.com/podcast/263-the-askgaryvee-show-27754057/?utm_medium=social&utm_source=linktree&utm_campaign=iheartradio",
        "text": "iHeartRadio",
        "kind": "CLASSIC",
        "section": null,
        "evidence": "embedded_state",
        "role": "link",
        "platform": "website",
        "handle": null,
        "position": 11
      },
      {
        "url": "https://tunein.com/podcasts/Entrepreneurship/The-GaryVee-Audio-Experience-p653815/",
        "rawUrl": "https://tunein.com/podcasts/Entrepreneurship/The-GaryVee-Audio-Experience-p653815/?utm_medium=social&utm_source=linktree&utm_campaign=tunein",
        "text": "TuneIn",
        "kind": "CLASSIC",
        "section": null,
        "evidence": "embedded_state",
        "role": "link",
        "platform": "website",
        "handle": null,
        "position": 12
      },
      {
        "url": "https://castbox.fm/channel/The-GaryVee-Audio-Experience-id257325?country=us",
        "rawUrl": "https://castbox.fm/channel/The-GaryVee-Audio-Experience-id257325?country=us&utm_medium=social&utm_source=linktree&utm_campaign=castbox",
        "text": "Castbox",
        "kind": "CLASSIC",
        "section": null,
        "evidence": "embedded_state",
        "role": "link",
        "platform": "website",
        "handle": null,
        "position": 13
      },
      {
        "url": "http://my.community.com/gary.vaynerchuk",
        "rawUrl": "http://my.community.com/gary.vaynerchuk?utm_medium=social&utm_source=linktree&utm_campaign=sign+up+to+join+my+texting+community",
        "text": "Sign up to join my texting community",
        "kind": "CLASSIC",
        "section": null,
        "evidence": "embedded_state",
        "role": "link",
        "platform": "website",
        "handle": null,
        "position": 14
      },
      {
        "url": "https://empathywines.com/",
        "rawUrl": "https://empathywines.com/?utm_medium=social&utm_source=linktree&utm_campaign=did+you+know+i+have+a+dtc+wine+brand%3F",
        "text": "Did you know I have a DTC wine brand?",
        "kind": "CLASSIC",
        "section": null,
        "evidence": "embedded_state",
        "role": "link",
        "platform": "website",
        "handle": null,
        "position": 15
      },
      {
        "url": "http://garyvee.com/youtubeGaryveeSUB",
        "rawUrl": "http://garyvee.com/youtubeGaryveeSUB?utm_medium=social&utm_source=linktree&utm_campaign=are+you+subscribed+to+my+youtube%3F",
        "text": "Are you subscribed to my YouTube?",
        "kind": "CLASSIC",
        "section": null,
        "evidence": "embedded_state",
        "role": "link",
        "platform": "website",
        "handle": null,
        "position": 16
      }
    ],
    "dropped": {
      "ownSite": 0,
      "share": 0,
      "chrome": 0
    }
  }
]

Requests and billing

  • Requests: 1 Web Access request per entry in items.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.