CPAlead Publisher API Documentation

Overview

What this API is designed for

Offer Sync

Pull available offers, filter by device or country, and use updated_since for incremental refreshes.

Tracking Safety

The Offers API never returns native CPC offers. Boost-click offers can appear, but they keep their normal rank.

OpenAPI File

The public OpenAPI file is available at /api/openapi.json .

01

অফার এপিআই

উপলব্ধ অফারগুলোর একটি জেসন তালিকা ফিরিয়ে দেয়. বৈশিষ্ট্যযুক্ত অফারগুলো আগে দেখানো যেতে পারে. এর পরে, কম offer_rank মান আগে দেখানো হয়.

র‌্যাঙ্কিং & দেশভিত্তিক পেআউট

প্রতিটি অফারে একটি অফার_র‌্যাঙ্ক থাকে যেখানে ১ হলো সর্বোচ্চ র‌্যাঙ্কের অফার. বৈশিষ্ট্যযুক্ত অফারগুলো আগে আসতে পারে. এর পরে, ফলাফল কম থেকে বেশি ক্রমে অফার_র‌্যাঙ্ক অনুযায়ী থাকে.
কিছু অফার দেশের ভেদে ভিন্ন পরিমাণ পরিশোধ করে. যদি কোনো অফারে "পৃথক দেশভিত্তিক পেআউট" তালিকা থাকে, তবে ব্যবহারকারীর দুই অক্ষরের দেশ কোডের সাথে মিলে এমন পেআউট ব্যবহার করুন (যেমন, US, CA, GB). যদি তাদের দেশ তালিকায় না থাকে, তবে "amount"-এ দেখানো ডিফল্ট পেআউট ব্যবহার করুন.

অফার এপিআই নোট

এই এপিআই সিপিসি অফার ফেরত দেয় না.
যদি কোনো অফারে বুস্ট ক্লিক থাকে, তবুও এটি তার স্বাভাবিক র‌্যাঙ্কই রাখে. শুধু বুস্ট ক্লিক থাকলেই এটি উপরে উঠে আসে না.
এপিআই যে সঠিক লিঙ্ক ফেরত দেয় তা ব্যবহার করলে সেরা অ্যাট্রিবিউশন পাওয়া যায়. আপনি যদি নিজস্ব সিস্টেমে লিঙ্ক সংরক্ষণ বা পুনর্গঠন করেন, তবুও ক্লিক কাজ করবে.

এন্ডপয়েন্ট

https://www.cpalead.com/api/offers?id={PUBLISHER_ID}

উপলব্ধ এইচটিটিপি কোয়েরি প্যারামিটার

এইচটিটিপি প্যারামিটার	বর্ণনা
id	Required. Your publisher ID.
country	শুধু নির্দিষ্ট দেশের অফার দেখান, দুই অক্ষরের আইএসও দেশ কোড দিতে হবে ব্যবহার করুন `country=user` ব্যবহারকারীর দেশের অফার স্বয়ংক্রিয়ভাবে পেতে
limit	ফেরত দেওয়া অফারের সংখ্যা সীমিত করুন. এতে আপনার এপিআই কল দ্রুত হতে পারে. ডিফল্ট ২৫০০ এবং সর্বোচ্চ ৫০০০.
type	এই এপিআই সিপিসি অফার ফেরত দেয় না. ডিফল্টভাবে এটি সিপিএ, সিপিআই, এবং সিপিই অফার ফেরত দেয়. আপনি কমা-আলাদা তালিকা দিয়ে সিপিআর ও অনুরোধ করতে পারেন, উদাহরণস্বরূপ `&type=cpi,cpe,cpr`
updated_since	Only return offers updated on or after this date. You can use YYYY-MM-DD or a full ISO date and time, for example `&updated_since=2026-04-01T00:00:00Z`
fields	Only return the offer fields you need. Use a comma-separated list, for example `&fields=id,title,link,amount,offer_rank` Available fields: `id, title, description, conversion, device, daily_cap, is_fast_pay, link, preview_link, amount, payout_currency, payout_type, countries, epc, creatives, offer_rank, payouts_per_country`
offerwall_offers	বুলিয়ান (সত্য\|মিথ্যা). আপনি যদি অফারওয়ালের জন্য চিহ্নিত অফারও চান তাহলে সত্য ব্যবহার করুন. সিপিসি অফার তবুও বাইরেই থাকে, এবং বুস্ট-ক্লিক অফারগুলো তাদের স্বাভাবিক র‌্যাঙ্কই রাখে.
device	স্বয়ংক্রিয় ডিভাইস টার্গেটিং ব্যবহার না করলে শুধুমাত্র এটি ব্যবহার করুন. ডিফল্টভাবে, এপিআই সব ধরনের ডিভাইস ফেরত দিতে পারে. শুধু নির্দিষ্ট ডিভাইস টাইপ ফেরত দিতে এই ক্ষেত্রটি ব্যবহার করুন. উপলব্ধ মানগুলো: ios, android, mobile, and desktop. ডিভাইস কমা-আলাদা তালিকাও হতে পারে, উদাহরণস্বরূপ: `&device=ios,android,mobile,desktop` শুধুমাত্র সিপিআই / সিপিই অফার পেতে (যেখানে রূপান্তরের জন্য শুধু ইনস্টল প্রয়োজন - ব্যবহার করুন device=ios,android ব্যবহার করুন `device=user` ব্যবহারকারীর ডিভাইস স্বয়ংক্রিয়ভাবে পেতে
subid / subid2 / subid3	সাবআইডি ট্র্যাকিং আপনাকে অতিরিক্ত তথ্য পাঠাতে দেয় যখন কোনো ব্যবহারকারী আপনার অ্যাফিলিয়েট লিঙ্কে ক্লিক করে, আপনার অ্যাফিলিয়েট লিঙ্কের শেষে একটি ট্যাগ পাঠিয়ে. এই প্যারামিটারটি স্বয়ংক্রিয়ভাবে আপনার ট্র্যাকিং লিঙ্কে সাবআইডি ভরবে. আপনি সাবআইডি ব্যবহার করে লিড বিভাজন, ক্যাম্পেইন অপ্টিমাইজ এবং রূপান্তর উন্নত করতে পারেন, উদাহরণগুলো হলো: সাব-অ্যাফিলিয়েট আইডি, উৎসগুলো (অর্গানিক, পিপিসি, ইমেইল ইত্যাদি), কীওয়ার্ড, অবস্থান ইত্যাদি... অতিরিক্ত তথ্যের জন্য দ্বিতীয় সাবআইডি ভেরিয়েবল অতিরিক্ত তথ্যের জন্য তৃতীয় সাবআইডি ভেরিয়েবল
gaid / idfa	মোবাইলের জন্য আপনার গুগল বিজ্ঞাপন আইডি (জিএআইডি) থাকলে, আপনার ট্র্যাকিং লিঙ্কে স্বয়ংক্রিয়ভাবে জিএআইডি ভরতে এই ভেরিয়েবলটি ব্যবহার করুন মোবাইলের জন্য আপনার অ্যাপল বিজ্ঞাপনদাতাদের জন্য পরিচয়কারী (আইডিএফএ) থাকলে, আপনার ট্র্যাকিং লিঙ্কে স্বয়ংক্রিয়ভাবে আইডিএফএ ভরতে এই ভেরিয়েবলটি ব্যবহার করুন
format / callback	জেসন অথবা জেসনপ ফরম্যাট. জেসন হল ডিফল্ট জেসনপি কলব্যাক ফাংশনের নাম. শুধুমাত্র জেসনপি ফরম্যাটের জন্য ব্যবহৃত হয়. জেকোয়েরি গেটজেসন ব্যবহার করলে, কলব্যাক=? ব্যবহার করুন এবং জেকোয়েরি স্বয়ংক্রিয়ভাবে আপনার জন্য ফাংশনের নাম ভরে দেবে. জেসনপি উদাহরণ দেখুন

প্রতিক্রিয়ার উদাহরণ

{
    "status": "success",
    "number_offers": 2,
    "country": "US",
    "devices": null,
    "offers": [
        {
            "id": 999001,
            "title": "QuizBlitz Pro",
            "description": "Test your knowledge and win rewards!",
            "conversion": "Complete Level 5 (New Users Only)",
            "device": "android",
            "daily_cap": 50,
            "is_fast_pay": true,
            "link": "https://{tracking_domain}/view.php?id=999001&pub={PUBLISHER_ID}&_src=api&_src_sig={SIGNATURE}",
            "preview_link": "https://example.com/offerblast",
            "amount": 1.2,
            "payout_currency": "USD",
            "payout_type": "CPE",
            "countries": [
                "US",
                "CA",
                "GB",
                "AU",
                "NZ"
            ],
            "epc": 0.95,
            "creatives": {
                "url": "https://{assets_domain}/images/offerblast.png"
            },
            "offer_rank": 7,
            "payouts_per_country": {
                "US": 1.2,
                "CA": 1.1,
                "GB": 0.9
            }
        },
        {
            "id": 999002,
            "title": "PhotoMaster Lite",
            "description": "Edit photos with one tap.",
            "conversion": "Install, open & keep for 2 days (New Users Only)",
            "device": "ios",
            "daily_cap": 100,
            "is_fast_pay": false,
            "link": "https://{tracking_domain}/view.php?id=999002&pub={PUBLISHER_ID}&_src=api&_src_sig={SIGNATURE}",
            "preview_link": "https://example.com/photomaster",
            "amount": 0.85,
            "payout_currency": "USD",
            "payout_type": "CPI",
            "countries": [
                "US"
            ],
            "epc": 1.1,
            "creatives": {
                "url": "https://{assets_domain}/images/photomaster.png"
            },
            "offer_rank": 12
        }
    ]
}

কোডের উদাহরণ

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>CPAlead Offers API Example</title>
</head>
<body>
    <div id="offer-list">Loading offers...</div>

document.getElementById("offer-list").innerHTML = html || "No offers found.";
            })
            .catch(() => {
                document.getElementById("offer-list").innerText = "Failed to load offers.";
            });
    </script>
</body>
</html>

02

রূপান্তর এপিআই

সীমা: প্রতি মিনিটে ১টি অনুরোধ
রূপান্তর এপিআই আপনাকে রূপান্তর পরীক্ষার জন্য সিপিএলিডকে পিং করতে দেয়, যা কাস্টম অ্যাপ তৈরির জন্য উপকারী. সাবআইডি অথবা আইপি ঠিকানা হিসেবে সাবআইডি পাঠান, অথবা "ব্যবহারকারী" পাঠান যাতে আমাদের সিস্টেম এই স্ক্রিপ্ট কল করা ক্লায়েন্টের আইপি ঠিকানা ব্যবহার করে (জেসনপি কলের জন্য উপকারী)
পুশ-ধরনের রূপান্তর সেবার জন্য (সার্ভার-টু-সার্ভার পোস্টব্যাক), আমাদের পোস্টব্যাক নথিপত্র দেখুন

এন্ডপয়েন্ট

https://www.cpalead.com/api/conversions?id={PUBLISHER_ID}&api_key={API_KEY}

উপলব্ধ এইচটিটিপি কোয়েরি প্যারামিটার

এইচটিটিপি প্যারামিটার	বর্ণনা
id	Required. Your publisher ID.
api_key	Required. Your API key.
subid	আবশ্যক. সাবআইডির ভিত্তিতে রূপান্তর খুঁজুন, সাবআইডি অথবা ব্যবহারকারীর আইপি ঠিকানা পাঠান, "ব্যবহারকারী" পাঠান ক্লায়েন্টের আইপি ঠিকানা ব্যবহার করতে যে এই স্ক্রিপ্ট কল করছে (জেসনপি কলের জন্য উপকারী)
offer_id	ঐচ্ছিক. শুধুমাত্র এই অফার (ক্যাম্পেইন) আইডির জন্য রূপান্তর যাচাই করবে
format / callback	জেসন অথবা জেসনপ ফরম্যাট. জেসন হল ডিফল্ট জেসনপি কলব্যাক ফাংশনের নাম. শুধুমাত্র জেসনপি ফরম্যাটের জন্য ব্যবহৃত হয়. জেকোয়েরি গেটজেসন ব্যবহার করলে, কলব্যাক=? ব্যবহার করুন এবং জেকোয়েরি স্বয়ংক্রিয়ভাবে আপনার জন্য ফাংশনের নাম ভরে দেবে. জেসনপি উদাহরণ দেখুন

প্রতিক্রিয়ার উদাহরণ

03

রিভার্সাল এপিআই

সীমা: প্রতি মিনিটে ১টি অনুরোধ
দুটি তারিখের মধ্যে আপনার খারাপ লিডগুলোর তালিকা ডাউনলোড করতে এই এপিআই ব্যবহার করুন. খারাপ ট্রাফিক বাছাই করার জন্য উপকারী

এন্ডপয়েন্ট

https://www.cpalead.com/api/reversals?id={PUBLISHER_ID}&api_key={API_KEY}

উপলব্ধ এইচটিটিপি কোয়েরি প্যারামিটার

এইচটিটিপি প্যারামিটার	বর্ণনা
id	Required. Your publisher ID.
api_key	Required. Your API key.
start_date	খারাপ লিড টানার সময় যে শুরুর তারিখ ব্যবহার করা হবে. ফরম্যাট: yyyy-mm-dd
end_date	খারাপ লিড টানার সময় যে শেষ তারিখ ব্যবহার করা হবে. একবারে সর্বোচ্চ এক মাস নেয়া যেতে পারে
format / callback	জেসন অথবা জেসনপ ফরম্যাট. জেসন হল ডিফল্ট জেসনপি কলব্যাক ফাংশনের নাম. শুধুমাত্র জেসনপি ফরম্যাটের জন্য ব্যবহৃত হয়. জেকোয়েরি গেটজেসন ব্যবহার করলে, কলব্যাক=? ব্যবহার করুন এবং জেকোয়েরি স্বয়ংক্রিয়ভাবে আপনার জন্য ফাংশনের নাম ভরে দেবে. জেসনপি উদাহরণ দেখুন

প্রতিক্রিয়ার উদাহরণ