דף הבית / תיעוד ה-API

מדריך ה-API

ה-API של Social links

פרופיל אחד של יוצר נכנס, כל החשבונות יוצאים. שלחו קישור לפרופיל ב-Instagram, ב-TikTok, ב-YouTube או ב-X וקבלו את החשבונות של היוצר בפלטפורמות האחרות, כל אחד עם הכרעה, ציון ביטחון והראיות שמאחוריו.

כתובת בסיסhttps://sociallinks.dev/v1

מה אפשר לעשות

חיפוש יוצרקישור פרופיל אחד נכנס, החשבונות האחרים של היוצר יוצאים.POST /resolveחיפוש יוצרים רביםהכניסו לתור עד 500 פרופילים; הם מעובדים ברקע.POST /batchesהורדת אצווה כ-CSVשורה לכל פרופיל שנשלח, עמודה לכל פלטפורמה, ובנוסף הסטטוס והקרדיטים שחויבו.GET /batches/{id}/exportבדיקת היתרההקרדיטים שנשארו בחשבון של המפתח.GET /balance

מפרט OpenAPIהחוזה המלא, למחוללי קוד ולסוכני AI.

הצגה

אימות

צרו מפתח ב-לוח הבקרה ← API ושלחו אותו בכל בקשה כ-Authorization: Bearer sl_… (או x-api-key: sl_…). המפתחות משתמשים בקרדיטים של החשבון שלכם. מפתח מוצג פעם אחת בלבד בעת יצירתו; אם תבטלו אותו, הוא יפסיק לעבוד מיד.

שרת MCP

חפשו מ-Claude Code, Cursor, VS Code, Windsurf, Gemini CLI או מכל לקוח MCP. הוסיפו את https://sociallinks.dev/mcp כשרת מרוחק (Streamable HTTP) ושלחו את מפתח ה-API בכותרת Authorization. הכלים מחויבים בדיוק כמו נקודות ה-REST.

claude mcp add --transport http sociallinks https://sociallinks.dev/mcp --header "Authorization: Bearer sl_your_key"

איפה זה נכנס: Cursor ~/.cursor/mcp.json · VS Code .vscode/mcp.json · Windsurf ~/.codeium/windsurf/mcp_config.json · Gemini CLI ~/.gemini/settings.json

כלים

lookup_creator
מחפש יוצר לפי כתובת פרופיל; מחויב רק כשנמצאים חשבונות.
check_balance
הקרדיטים שנותרו בחשבון של המפתח. בחינם.
start_batch
מכניס לתור הרבה כתובות פרופילים לחיפוש ברקע.
get_batch
התקדמות ושורות של אצווה.

חיוב

1 קרדיט ליוצר כשאנחנו מוצאים לפחות חשבון אחד מעבר לזה ששלחתם. חיפושים שלא מוצאים כלום, וחיפושים שנכשלים, הם בחינם. חיפוש חוזר של יוצר שהחשבון שלכם שילם עליו ב-30 הימים האחרונים הוא בחינם. הקרדיטים משותפים עם האתר; ראו מחירים.

חיפוש יוצר

POST/resolve

שלחו כתובת URL אחת של פרופיל ב-Instagram, ב-TikTok, ב-YouTube או ב-X. תקבלו את החשבונות של היוצר בפלטפורמות האחרות, כל אחד עם הכרעה, ציון ביטחון נטו והראיות שמאחוריו. חיפוש חדש לוקח 10–40 שניות; יוצרים שכבר יש לנו חוזרים מיד. 1 קרדיט כשנמצא לפחות חשבון אחד; אם לא נמצא כלום, זה בחינם. הכותרת X-Credits-Remaining מכילה את היתרה שלכם.

פרמטרים

urlbody · stringחובה
דף הפרופיל של יוצר. פוסטים, ריילס, סרטונים ו-@כינויים בודדים נדחים עם 400.

בקשה

curl -X POST "https://sociallinks.dev/v1/resolve" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.instagram.com/mkbhd"}'

תגובה (200)

{
  "creator": {
    "id": "cr_0k3x9a1",
    "name": "Marques Brownlee",
    "kind": "person",
    "aliases": ["Marques Brownlee", "mkbhd"],
    "total_audience": 38000000
  },
  "profiles": [
    { "platform": "instagram", "handle": "mkbhd", "verdict": "seed", "net_confidence": 1 },
    {
      "platform": "youtube",
      "handle": "mkbhd",
      "url": "https://www.youtube.com/@mkbhd",
      "followers": 20000000,
      "verdict": "confirmed",
      "net_confidence": 0.97,
      "evidence": [
        { "kind": "bio_link", "detail": "Linked from the creator's own Instagram bio", "source": "https://www.instagram.com/mkbhd" }
      ]
    }
  ],
  "websites": [{ "url": "https://mkbhd.com", "kind": "website", "label": "mkbhd.com" }],
  "identity_confidence": 0.96,
  "rejected": 4
}

חיפוש יוצר (GET)

GET/resolve

זהה ל-POST /resolve, לכלים שיכולים לשלוח רק בקשות GET.

פרמטרים

urlquery · stringחובה
דף הפרופיל של יוצר, בקידוד URL.

בקשה

curl "https://sociallinks.dev/v1/resolve?url=https%3A%2F%2Fwww.instagram.com%2Fmkbhd" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

תגובה (200)

{
  "creator": {
    "id": "cr_0k3x9a1",
    "name": "Marques Brownlee",
    "kind": "person",
    "aliases": ["Marques Brownlee", "mkbhd"],
    "total_audience": 38000000
  },
  "profiles": [
    { "platform": "instagram", "handle": "mkbhd", "verdict": "seed", "net_confidence": 1 },
    {
      "platform": "youtube",
      "handle": "mkbhd",
      "url": "https://www.youtube.com/@mkbhd",
      "followers": 20000000,
      "verdict": "confirmed",
      "net_confidence": 0.97,
      "evidence": [
        { "kind": "bio_link", "detail": "Linked from the creator's own Instagram bio", "source": "https://www.instagram.com/mkbhd" }
      ]
    }
  ],
  "websites": [{ "url": "https://mkbhd.com", "kind": "website", "label": "mkbhd.com" }],
  "identity_confidence": 0.96,
  "rejected": 4
}

חיפוש יוצרים רבים

POST/batches

כל שורה מחויבת רק אם נמצאו בה חשבונות, ושורות שהחשבון שלכם שילם עליהן ב-30 הימים האחרונים הן בחינם. שורות שאינן קישורי פרופיל מדולגות ולעולם לא מחויבות. בדקו את מצב האצווה, ואז הורידו את קובץ ה-CSV.

פרמטרים

urlsbody · string[] | stringחובה
עד 500 כתובות פרופיל, כמערך או אחת בכל שורה.
namebody · string
תווית לאצווה.

בקשה

curl -X POST "https://sociallinks.dev/v1/batches" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Q4 shortlist","urls":["https://www.tiktok.com/@zachking","https://www.youtube.com/@mkbhd"]}'

תגובה (201)

{
  "id": "6f1c2a4e-1b2c-4d3e-9f00-0a1b2c3d4e5f",
  "rows": 2,
  "invalid": 0,
  "duplicates": 0
}

בדיקת אצווה

GET/batches/{id}

בדקו כל כמה שניות עד שהסטטוס הוא "completed", "partial" או "failed". לכל פריט יש סטטוס משלו והחשבונות שנמצאו.

פרמטרים

idpath · uuidחובה
ה-id ש-POST /batches החזיר.

בקשה

curl "https://sociallinks.dev/v1/batches/$BATCH_ID" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

תגובה (200)

{
  "batch": {
    "id": "6f1c2a4e-1b2c-4d3e-9f00-0a1b2c3d4e5f",
    "name": "Q4 shortlist",
    "status": "completed",
    "total": 2,
    "succeeded": 2,
    "empty": 0,
    "failed": 0,
    "skipped": 0,
    "charged": 2,
    "created_at": "2026-10-19T09:30:00Z"
  },
  "items": [
    {
      "position": 0,
      "input": { "url": "https://www.tiktok.com/@zachking" },
      "status": "succeeded",
      "charged": 1,
      "result": {
        "name": "Zach King",
        "profiles": [{ "platform": "youtube", "handle": "ZachKing", "url": "https://www.youtube.com/@ZachKing", "verdict": "confirmed" }],
        "notFound": ["linkedin"]
      }
    }
  ]
}

הורדת אצווה כ-CSV

GET/batches/{id}/export

מוכן לגיליון אלקטרוני או לייבוא ל-CRM.

פרמטרים

idpath · uuidחובה
ה-id של האצווה.

בקשה

curl "https://sociallinks.dev/v1/batches/$BATCH_ID/export" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY" -o results.csv

תגובה (200)

row,input,status,credits,creator,verified_creator,instagram,youtube,tiktok,x,twitch,facebook,linkedin,nothing_found_on,error
1,https://www.tiktok.com/@zachking,succeeded,1,Zach King,no,https://www.instagram.com/zachking,https://www.youtube.com/@ZachKing,https://www.tiktok.com/@zachking,https://x.com/zachking,,https://www.facebook.com/zachking,,linkedin,

רשימת האצוות שלכם

GET/batches

שימושי כדי להמשיך מאיפה שהפסקתם.

פרמטרים

אין.

בקשה

curl "https://sociallinks.dev/v1/batches" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

תגובה (200)

{
  "batches": [
    {
      "id": "6f1c2a4e-1b2c-4d3e-9f00-0a1b2c3d4e5f",
      "name": "Q4 shortlist",
      "status": "completed",
      "total": 2,
      "succeeded": 2,
      "empty": 0,
      "failed": 0,
      "skipped": 0,
      "charged": 2,
      "created_at": "2026-10-19T09:30:00Z"
    }
  ]
}

עצירת אצווה

POST/batches/{id}/cancel

שורות שכבר רצות מסתיימות. מחזיר 409 אם האצווה כבר הסתיימה.

פרמטרים

idpath · uuidחובה
ה-id של האצווה.

בקשה

curl -X POST "https://sociallinks.dev/v1/batches/$BATCH_ID/cancel" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

תגובה (200)

{ "ok": true }

בדיקת היתרה

GET/balance

אותם קרדיטים שהאתר משתמש בהם. קנו חבילות ב-https://sociallinks.dev/pricing.

פרמטרים

אין.

בקשה

curl "https://sociallinks.dev/v1/balance" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

תגובה (200)

{ "credits": 742 }

שגיאות

כל שגיאה היא בצורה { "error": { "message", "code" } }. ההודעה קריאה; הקוד קיים למקרים שבהם תרצו להסתעף לפיו.

סטטוס	קוד	משמעות
400	`—`	זו לא כתובת של פרופיל (פוסטים, ריילס, סרטונים ו-@כינויים בודדים נדחים), או שאין גוף בקשה.
401	`invalid_api_key`	המפתח לא מוכר או שבוטל.
401	`login_required`	לא נשלח מפתח.
402	`out_of_credits`	לא נשארו קרדיטים. לא חויבתם; קנו חבילה ונסו שוב.
404	`—`	אין אצווה כזו בחשבון הזה.
409	`—`	האצווה כבר הסתיימה.
429	`—`	יותר מדי חיפושים חדשים. המתינו את מספר השניות שב-Retry-After, או שלחו את הרשימה ל-/batches.
502	`—`	החיפוש נכשל אצלנו. לא חויבתם; נסו שוב.

מגבלות קצב

חיפושים חדשים לכל מפתח	5 בדקה
יוצרים שכבר חופשו	ללא הגבלה; תשובה מיידית
פרופילים לכל אצווה	500
מפתחות API פעילים לכל חשבון	10

תמיכה

שאלות או באג? כתבו ל-support@youtubetranscript.dev.