Linktree sayfası

GET/v1/linktree1 kredi

Herkese açık bir Linktree sayfasını döndürür: içerik üreticisinin kimliği, kullanıcı adı, görseli, açıklaması, kategorileri, saat dilimi ve tüm bağlantıları (id, tür, başlık, url); ayrıca her sosyal simge için bir alan (`instagram`, `tiktok`, `email_address`, …).

01Sorgu parametreleri

Ad	Tür	Açıklama
urlzorunlu	string	Linktree sayfa URL'si, örneğin `https://linktr.ee/miguelangeles`.
cache_max_ageisteğe bağlı	string	Uyumluluk için kabul edilir: önbellekteki bir yanıtın en fazla ne kadar eski olabileceğini belirtir. Her çağrı canlı olarak çekildiği için yanıtı da fiyatı da değiştirmez.Kabul edilen değerler:`1d3d7d14d30d`

02İstek

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

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

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]"
}

Tüm uç noktalarda ortak

Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.

GET /v1/cosmos/profile?handle=design

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

04Notlar

Sosyal simgeler, türlerinin küçük harfli adını taşıyan alanlar olarak sayfadaki sırayla gelir; sayfada olmayan bir simgenin alanı yoktur. Bulunamayan bir sayfa ücretsiz 404, başka bir sitenin URL'si ücretsiz 400 döner.

05Hatalar ve krediler

Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.

400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.