BuyLinksForSEO API গাইড

প্রকাশক গবেষণা এবং ব্যাকলিংক অর্ডার আপনার নিজের টুলের সাথে সংযুক্ত করুন। এই রেফারেন্সে প্রমাণীকরণ, অনুরোধের ফর্ম্যাট, অর্ডার-টু-পাবলিকেশন ওয়ার্কফ্লো এবং প্রতিক্রিয়া অন্তর্ভুক্ত। আপনার ইন্টিগ্রেশনগুলো আপনার BuyLinksForSEO অ্যাকাউন্টের একই ব্যালেন্স এবং অর্ডার ব্যবহার করে।

বেস URL ও প্রমাণীকরণ

  • বেস URL https://buylinksforseo.com
  • সংস্করণ প্রিফিক্স /v1
  • প্রমাণীকরণ 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: keep the OUTPUT FORMAT ব্লক এবং এটি যথাযথভাবে চলে।

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

আপনার বাস্কেটে ব্যাকলিংক অর্ডার তৈরি করুন — no charge yet. donor_ids সর্বদা প্রয়োজন; তারপর নির্বাচন করুন তিনটি কন্টেন্ট মোডের একটি:

  • অটো — পাঠান target_url + keyword: we research & write the article.
  • আপনার প্রম্পট থেকে — এছাড়াও পাঠান recommendations (বেস প্রম্পটটি আনুন এবং সম্পাদনা করুন এর মাধ্যমে GET /v1/article-prompt); আমরা আপনার ব্রিফে লিখি।
  • আপনার নিজের নিবন্ধ — পাঠান content (+ ঐচ্ছিক title, article_url); আমরা আপনার প্রস্তুত HTML যেমন আছে তেমনই প্রকাশ করি। আপনার অ্যাকাউন্টে নিজের-কন্টেন্ট সক্ষম করা প্রয়োজন।
// 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. সাইট খুঁজুন — GET /v1/donors প্রাসঙ্গিক, প্রকৃত ট্রাফিকের ডোনার বাছাই করতে।
  2. অর্ডার — POST /v1/orders দাতা আইডি এবং আপনার পেজ/কাওয়ার্ড সহ → আইটেমগুলো আপনার বাস্কেটে যোগ হয়। কন্টেন্ট মোড নির্বাচন করুন: অটো, আপনার সম্পাদিত প্রম্পট (recommendations, দেখুন GET /v1/article-prompt), অথবা আপনার নিজের content.
  3. রিভিউ — GET /v1/basket ড্রাফট এবং মোট পরীক্ষা করতে।
  4. প্রকাশ করুন — POST /v1/basket/pay আপনার ব্যালেন্স থেকে পরিশোধ করে এবং লিংকগুলো লাইভ করে দেয় (~২৪ ঘণ্টা)।
  5. ট্র্যাক — GET /v1/links স্ট্যাটাস এবং প্রকাশিত URL-এর জন্য।

ত্রুটি

  • 401 unauthorized — কী অনুপস্থিত / অবৈধ / প্রত্যাহৃত
  • 400 bad_request / payment_failed — খারাপ বডি, অথবা ব্যালেন্স বাস্কেট কভার করতে পারছে না
  • 403 forbidden / own_content_disabled — কী অর্ডার করতে পারে না, অথবা আপনার অ্যাকাউন্টে own-content সক্রিয় নেই
  • 404 not_found — অজানা এন্ডপয়েন্ট বা রিসোর্স
  • 405 method_not_allowed
  • 500 server_error — transient; পুনরায় চেষ্টা করুন

AI এজেন্টদের জন্য: Bearer key দিয়ে প্রমাণীকরণ করুন, কল করুন GET /v1/me অ্যাকাউন্ট নিশ্চিত করতে, GET /v1/donors সাইট খুঁজে পেতে, তারপর POST /v1/orders → POST /v1/basket/pay অর্ডার এবং প্রকাশ করতে। অথবা HTTP সম্পূর্ণভাবে এড়িয়ে যান এবং ব্যবহার করুন MCP সার্ভার — একই কী, নেটিভ টুলস।