Linktree page

GET/v1/linktree1 credit

Returns a public Linktree page: the creator's id, username, picture, description, verticals, time zone and every link (id, type, title, url), plus one field per social icon (`instagram`, `tiktok`, `email_address`, …).

01Query parameters

Name	Type	Description
urlrequired	string	Linktree page URL, e.g. `https://linktr.ee/miguelangeles`.
cache_max_ageoptional	string	Accepted for compatibility: how old a cached answer may be. Every call is fetched fresh, so it does not change the answer or the price.Accepted values:`1d3d7d14d30d`

02Request

curl "https://api.scrapesocial.ai/v1/linktree?url=https%3A%2F%2Flinktr.ee%2Fmiguelangeles" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/linktree?url=https%3A%2F%2Flinktr.ee%2Fmiguelangeles

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": 15278008,
  "username": "miguelangeles",
  "profilePictureUrl": "https://ugc.production.linktr.ee/d3141538-f586-4f3f-bc9a-a82fbebab798_DEATHRATTLE-slowed-COVER.jpeg",
  "description": "☆☆☆☆ IRL ANGEL ☆☆☆☆\nψ EMBRACE CHAOS ψ",
  "verticals": [
    "music",
    "creative"
  ],
  "linkPlatforms": [
    "TikTok",
    "Instagram"
  ],
  "timezone": "America/New_York",
  "links": [
    {
      "id": 463416775,
      "type": "SPOTIFY_ALBUM",
      "title": "new project \"BEFORE THE SUN RISES & WINTERR ENDS\"",
      "url": "https://open.spotify.com/album/0pgrg7phBbnwGJ2HBEl9EG?si=Zub7J4I3RySAaM9WVX3Okg"
    },
    {
      "id": 460281204,
      "type": "SPOTIFY_SONG",
      "title": "stream \"NOVEMBERR\"",
      "url": "https://open.spotify.com/track/62HnBMEdZjeFCd2T8g37T8?si=7bd35dd0e9f24d65"
    }
  ],
  "instagram": "https://instagram.com/miguelangeles",
  "tiktok": "https://tiktok.com/@irlangel",
  "spotify": "https://open.spotify.com/artist/14xRX3JR8H4RWh8R7V3fvZ?si=EgRxWIPiRcaEHtSnqk5PAQ",
  "youtube": "https://www.youtube.com/watch?v=xiFUzOJaiC4",
  "soundcloud": "https://soundcloud.com/miguelangeles",
  "apple_music": "https://music.apple.com/ca/artist/miguel-angeles/1209423162",
  "email_address": "[email protected]"
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Social icons appear as fields named after their type in lower case, in the page's order; an icon the page does not have is absent. An unknown page is a free 404; a URL of another site is a free 400.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.