Get a public Linktree page
curl --request GET \
--url https://api.scraperize.com/v1/linktree/page \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/linktree/page"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.scraperize.com/v1/linktree/page', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scraperize.com/v1/linktree/page",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.scraperize.com/v1/linktree/page"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.scraperize.com/v1/linktree/page")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/linktree/page")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"page": {
"username": "pharrell",
"accountId": 3025568,
"uuid": "b18d6498-3f5d-11eb-85b8-0a26086d88df",
"title": "@pharrell",
"name": "Pharrell Williams",
"description": null,
"isVerified": true,
"isActive": true,
"avatarUrl": "https://ugc.production.linktr.ee/54f5ea79-e633-456d-b88d-f75656c977dc_Screenshot-2025-05-06-at-7.42.05-AM.png",
"avatarType": "IMAGE",
"avatarShape": "CIRCLE_SMALL",
"bannerImageUrl": null,
"bannerType": "IMAGE",
"createdAt": "2019-08-23T09:48:16.000Z",
"updatedAt": "2026-08-31T09:54:19.000Z",
"socialLinksPosition": "TOP",
"metaTitle": "Pharrell Williams | Linktree",
"metaDescription": "Follow my Linktree for the latest.",
"theme": {
"key": "custom",
"luminance": "LIGHT",
"backgroundColor": "#ffffff",
"backgroundStyle": "FLAT",
"backgroundType": "COLOR",
"buttonType": "HARDSHADOW_CIRCULAR",
"buttonColor": "#ffffff",
"buttonTextColor": "#000000",
"buttonCornerType": "ROUNDED_FULL",
"buttonShadowColor": "#000000",
"socialColor": "#000000",
"fontFamily": "dm sans",
"fontColor": "#000000"
},
"socialLinks": [
{
"type": "FACEBOOK",
"url": "https://facebook.com/pharrell",
"position": 0
},
{
"type": "INSTAGRAM",
"url": "https://instagram.com/pharrell",
"position": 0
},
{
"type": "TIKTOK",
"url": "https://tiktok.com/@pharrell",
"position": 0
}
],
"links": [
{
"id": "13210175",
"type": "CLASSIC",
"title": "PHARRELLWILLIAMS.COM",
"url": "https://pharrellwilliams.com/",
"thumbnailUrl": null,
"position": 0,
"locked": false,
"gateTypes": null,
"layout": "stack",
"amazonAffiliate": false,
"meta": {
"title": "Pharrell Williams",
"description": "Dress Up Pharrell",
"image": "https://pharrellwilliams.com/opengraph-image.png?opengraph-image.1kc5_rpella_-.png"
},
"children": null
},
{
"id": "498208380",
"type": "CLASSIC",
"title": "VIRGINIA",
"url": "http://blackyachtrock.com",
"thumbnailUrl": "https://ugc.production.linktr.ee/bf7cf3fc-89b5-4173-b46d-e174d5d428ac_virginia-opengraph-2025.png",
"position": 1,
"locked": false,
"gateTypes": null,
"layout": "stack",
"amazonAffiliate": false,
"meta": {
"title": null,
"description": null,
"image": null
},
"children": null
},
{
"id": "477277634",
"type": "CLASSIC",
"title": "Louis Vuitton Menswear",
"url": "https://us.louisvuitton.com/eng-us/new/for-men/new-this-season/_/N-t1blflj9",
"thumbnailUrl": "https://ugc.production.linktr.ee/650e26ba-d3f7-480c-8788-8c97fa0dc554_Untitled-design--4-.png",
"position": 3,
"locked": false,
"gateTypes": null,
"layout": "stack",
"amazonAffiliate": false,
"meta": {
"title": null,
"description": null,
"image": null
},
"children": null
}
],
"pinnedLinks": [],
"storefront": {
"hasCommissionProducts": false,
"itemCount": 0,
"postCount": 0,
"items": [],
"posts": []
},
"linkCount": 9,
"totalLinkCount": 9,
"socialCount": 7
},
"fetchedAt": "2026-09-14T12:14:45.519Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "API key required — pass it in the `x-api-key` header.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "This request costs 1 credit, but your balance is 0. Top up to continue.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "The requested content was not found (it may not exist, be deleted, or be private).",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"details": [
{
"path": "url",
"message": "Required"
}
]
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded — max 100 requests per 60s. Retry in ~30s.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UPSTREAM_BLOCKED",
"message": "The source was temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}Linktree
Get a public Linktree page
Fetches a public Linktree page by URL: the profile (name, avatar, verification, theme, social links) and the page links — each with its title, url, thumbnail, preview metadata, nested children, and gating — plus any storefront items.
GET
/
v1
/
linktree
/
page
Get a public Linktree page
curl --request GET \
--url https://api.scraperize.com/v1/linktree/page \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/linktree/page"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.scraperize.com/v1/linktree/page', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scraperize.com/v1/linktree/page",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.scraperize.com/v1/linktree/page"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.scraperize.com/v1/linktree/page")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/linktree/page")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"page": {
"username": "pharrell",
"accountId": 3025568,
"uuid": "b18d6498-3f5d-11eb-85b8-0a26086d88df",
"title": "@pharrell",
"name": "Pharrell Williams",
"description": null,
"isVerified": true,
"isActive": true,
"avatarUrl": "https://ugc.production.linktr.ee/54f5ea79-e633-456d-b88d-f75656c977dc_Screenshot-2025-05-06-at-7.42.05-AM.png",
"avatarType": "IMAGE",
"avatarShape": "CIRCLE_SMALL",
"bannerImageUrl": null,
"bannerType": "IMAGE",
"createdAt": "2019-08-23T09:48:16.000Z",
"updatedAt": "2026-08-31T09:54:19.000Z",
"socialLinksPosition": "TOP",
"metaTitle": "Pharrell Williams | Linktree",
"metaDescription": "Follow my Linktree for the latest.",
"theme": {
"key": "custom",
"luminance": "LIGHT",
"backgroundColor": "#ffffff",
"backgroundStyle": "FLAT",
"backgroundType": "COLOR",
"buttonType": "HARDSHADOW_CIRCULAR",
"buttonColor": "#ffffff",
"buttonTextColor": "#000000",
"buttonCornerType": "ROUNDED_FULL",
"buttonShadowColor": "#000000",
"socialColor": "#000000",
"fontFamily": "dm sans",
"fontColor": "#000000"
},
"socialLinks": [
{
"type": "FACEBOOK",
"url": "https://facebook.com/pharrell",
"position": 0
},
{
"type": "INSTAGRAM",
"url": "https://instagram.com/pharrell",
"position": 0
},
{
"type": "TIKTOK",
"url": "https://tiktok.com/@pharrell",
"position": 0
}
],
"links": [
{
"id": "13210175",
"type": "CLASSIC",
"title": "PHARRELLWILLIAMS.COM",
"url": "https://pharrellwilliams.com/",
"thumbnailUrl": null,
"position": 0,
"locked": false,
"gateTypes": null,
"layout": "stack",
"amazonAffiliate": false,
"meta": {
"title": "Pharrell Williams",
"description": "Dress Up Pharrell",
"image": "https://pharrellwilliams.com/opengraph-image.png?opengraph-image.1kc5_rpella_-.png"
},
"children": null
},
{
"id": "498208380",
"type": "CLASSIC",
"title": "VIRGINIA",
"url": "http://blackyachtrock.com",
"thumbnailUrl": "https://ugc.production.linktr.ee/bf7cf3fc-89b5-4173-b46d-e174d5d428ac_virginia-opengraph-2025.png",
"position": 1,
"locked": false,
"gateTypes": null,
"layout": "stack",
"amazonAffiliate": false,
"meta": {
"title": null,
"description": null,
"image": null
},
"children": null
},
{
"id": "477277634",
"type": "CLASSIC",
"title": "Louis Vuitton Menswear",
"url": "https://us.louisvuitton.com/eng-us/new/for-men/new-this-season/_/N-t1blflj9",
"thumbnailUrl": "https://ugc.production.linktr.ee/650e26ba-d3f7-480c-8788-8c97fa0dc554_Untitled-design--4-.png",
"position": 3,
"locked": false,
"gateTypes": null,
"layout": "stack",
"amazonAffiliate": false,
"meta": {
"title": null,
"description": null,
"image": null
},
"children": null
}
],
"pinnedLinks": [],
"storefront": {
"hasCommissionProducts": false,
"itemCount": 0,
"postCount": 0,
"items": [],
"posts": []
},
"linkCount": 9,
"totalLinkCount": 9,
"socialCount": 7
},
"fetchedAt": "2026-09-14T12:14:45.519Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "API key required — pass it in the `x-api-key` header.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "This request costs 1 credit, but your balance is 0. Top up to continue.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "The requested content was not found (it may not exist, be deleted, or be private).",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"details": [
{
"path": "url",
"message": "Required"
}
]
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded — max 100 requests per 60s. Retry in ~30s.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UPSTREAM_BLOCKED",
"message": "The source was temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}Authorizations
Your API key. Send it in the x-api-key header (or Authorization: Bearer <key>). Create and manage keys from your dashboard.
Query Parameters
Public Linktree page URL, e.g. https://linktr.ee/pharrell.
Optional. Return a cached result if one this age or newer exists — served for 0 credits with meta.cached=true and meta.cachedAt. Otherwise a fresh scrape runs (1 credit) and refreshes the cache. Omit to always scrape fresh.
Available options:
1d, 3d, 7d, 14d, 30d