מדריך ה-API של BuyLinksForSEO

חברו מחקר מפרסמים והזמנות קישורים חוזרים לכלים שלכם. עיון זה מכסה אימות, פורמטים של בקשות, תהליך הזמנה-לפרסום ותגובות. האינטגרציות שלכם משתמשות באותה יתרה והזמנות כמו חשבון BuyLinksForSEO שלכם.

כתובת URL בסיסית ואימות

  • כתובת URL בסיסית https://buylinksforseo.com
  • קידומת גרסה /v1
  • Auth Authorization: Bearer <your_api_key> (או ?api_key=…)
  • סוג תוכן application/json

צרו והעתיקו מפתחות בלוח הבקרה שלכם → API. מפתח שייך לחשבון אחד ופועל עליו. ה-API יכול לעשות הכל מלבד לטעון את היתרה שלכם — הוספת כספים נשארת בלוח הבקרה.

פורמט תגובה

כל תגובה היא JSON. מעטפות הצלחה ושגיאה:

{ "success": true, "data": { … } }
{ "success": false, "error": { "code": "unauthorized", "message": "…" } }

נקודות קצה

GET/v1/me

החשבון שלך.

{ "success": true, "data": { "id": 123, "email": "[email protected]", "name": "You", "balance": 45.00 } }
GET/v1/balance

יתרת חשבון נוכחית (USD).

GET/v1/donors

אתרי תורמים בשוק (עם עימוד, 20/עמוד). פרמטרי שאילתה אופציונליים: page, domain_filter, ext_filter, dr_min, referring_domains_min, price_filter, top100_filter.

{ "success": true, "data": [ { "id": 42, "domain": "blog.com", "dr": 61, "price": 12 } ],
  "pagination": { "current_page": 1, "total_pages": 478, "total_records": 9543 } }
GET/v1/article-prompt

מחזיר את הפרומפט המדויק שבו אנו משתמשים לכתיבת המאמר — כך שתוכל לקרוא אותו ולערוך אותו. פרמטרי שאילתה אופציונליים: keyword, target_url, language, recommendations. ערכו את הפרומפט שהוחזר והעבירו אותו בחזרה ל POST /v1/orders כ recommendations; שמרו על ה OUTPUT FORMAT חסום והוא רץ כמו שהוא.

{ "success": true, "data": { "default_prompt": "…", "editable_field": "recommendations",
    "modes": { "own": "…", "prompt": "…", "auto": "…" } } }
POST/v1/orders

צרו הזמנות קישורים נכנסים לסל שלכם — no charge yet. donor_ids תמיד נדרש; לאחר מכן בחרו אחת משלוש תוכניות תוכן:

  • רכב — send target_url + keyword; אנחנו חוקרים וכותבים את המאמר.
  • מההנחיה שלך — also send recommendations (אחזר וערוך את הפרומפט הבסיסי דרך GET /v1/article-prompt); אנו כותבים לפי הבריף שלך.
  • המאמר שלך — send content (+ אופציונלי title, article_url; אנו מפרסמים את ה-HTML המוכן שלך כמו שהוא. דורש הפעלת own-content בחשבונכם.
// auto
{ "donor_ids": [42, 43], "target_url": "https://you.com/pricing", "keyword": "best crm", "language": "en" }
// from your prompt
{ "donor_ids": [42], "target_url": "https://you.com", "keyword": "best crm", "recommendations": "Friendly tone, cite 2 studies…" }
// your own article
{ "donor_ids": [42], "content": "<article>…</article>", "title": "My headline" }
{ "success": true, "data": { "mode": "auto", "order_content_ids": [9001, 9002],
    "basket_ids": [55, 56], "total_price": 24, "status": "in_basket" } }
GET/v1/basket

בדוק מה נמצא כרגע בסל שלך (מאמרים בטיוטה, תורם, מחיר) לפני פרסום.

POST/v1/basket/pay

פרסמו הכל בסל שלכם, תוך תשלום מיתרת החשבון. אם היתרה אינה מספקת, שום דבר לא יפורסם ויחזור success:false עם כמה עוד נדרש. טעינה מתבצעת רק בלוח הבקרה.

{ "success": true, "data": { "status": "published", "charged": 24, "links": 2 } }
GET/v1/links

הקישורים שהזמנת (קישורים נכנסים) עם סטטוס וכתובת URL שפורסמה. /v1/orders (GET) הוא כינוי.

{ "success": true, "count": 1, "data": [
  { "id": 8891, "target_url": "https://you.com/pricing", "keyword": "best crm",
    "status": "active", "published_url": "https://donor.com/…?aio-…", "cost": "12.00" } ] }

תהליך הזמנה

  1. Find sites — GET /v1/donors כדי לבחור תורמים רלוונטיים עם תעבורה אמיתית.
  2. הזמנה — POST /v1/orders עם מזהי התורמים והדף/מילת המפתח שלכם ← הפריטים נכנסים לסל שלכם. בחרו את מצב התוכן: אוטומטי, הפרומפט הערוך שלכם (recommendations, ראו GET /v1/article-prompt), או שלך content.
  3. ביקורת — GET /v1/basket לבדוק את הטיוטות והסכום הכולל.
  4. פרסום — POST /v1/basket/pay משלם מהיתרה שלך ומעלה את הקישורים לאוויר (~24 שעות).
  5. עקוב — GET /v1/links לסטטוס ולכתובות URL שפורסמו.

שגיאות

  • 401 unauthorized — missing / invalid / revoked key
  • 400 bad_request / payment_failed — גוף גרוע, או שהיתרה לא יכולה לכסות את הסל
  • 403 forbidden / own_content_disabled — המפתח לא יכול להזמין, או שתוכן עצמי אינו מופעל בחשבונך
  • 404 not_found — unknown endpoint or resource
  • 405 method_not_allowed
  • 500 server_error — transient; retry

לסוכני AI: אמת עם מפתח Bearer, קרא ל- GET /v1/me לאשר את החשבון, GET /v1/donors למצוא אתרים, ואז POST /v1/orders → POST /v1/basket/pay כדי להזמין ולפרסם. או לדלג על HTTP לחלוטין ולהשתמש ב- שרת MCP — same key, native tools.