డెవలపర్ డాక్యుమెంటేషన్

ప్రతి అభ్యర్థనను బేరర్ స్కీమ్‌ను ఉపయోగించి, అథరైజేషన్ హెడర్‌లోని రహస్య కీతో ప్రామాణీకరించబడుతుంది.

POST https://api.adhub365.com/v1/partner/ads
Authorization: Bearer sk_sandbox_...
Content-Type: application/json

మీ API కీలు మీ స్వంత వినియోగదారుల కోసం ప్రకటనదారు ఖాతాలను సృష్టిస్తే (కనెక్ట్ మోడ్ — పైన ఉన్న ప్రామాణీకరణను చూడండి), ఆ ప్రకటనదారులు వారి ప్రకటనల కోసం చెల్లించే దానిలో మీరు ఒక వాటాను పొందుతారు. క్రింద ఉన్న విభజనను ఈ same ఎండ్‌పాయింట్ నుండి నేరుగా చదువుతారు, ఎప్పుడూ హార్డ్‌కోడ్ చేయరు, మరియు ఇది ఈ పేజీలో ఇంకా కింద ఉన్న రిఫరల్ కమీషన్‌కు పూర్తిగా వేరుగా ఉంటుంది.

GET https://api.adhub365.com/v1/partner-program

{
  "partner_share_percentage": 0.7,
  "platform_share_percentage": 0.3
}

ఇది ఎలా పనిచేస్తుంది

1. మీ కనెక్ట్-మోడ్ ప్రకటనదారులలో ఒకరు మీ ఇంటిగ్రేషన్ ద్వారా ఒక ప్రకటనకు చెల్లిస్తారు.
2. ప్రకటన సమీక్షించబడి, ఆమోదించబడుతుంది — స్వయంచాలకంగా, లేదా మా మోడరేషన్ బృందం ద్వారా.
3. మీ వాటా మీ వాలెట్‌కు ఆటోమేటిక్‌గా చెల్లించడానికి క్యూలో ఉంది, ఇది కింద ఉన్న రిఫరల్ ప్రోగ్రామ్ లాంటి పద్ధతే.

చెల్లింపు షరతులు

• మీ భాగస్వామి ఖాతాలో ఒక క్రిప్టో చెల్లింపు వాలెట్ కాన్ఫిగర్ చేయబడింది.
• మీ వైపు నుండి KYC అవసరం లేదు — మీ భాగస్వామి ఖాతా సృష్టించబడినప్పుడే ఇప్పటికే పరిశీలించబడింది.

ఉదాహరణ: పేరుకుపోయిన వాటాలను చదవడం

GET https://api.adhub365.com/v1/partner/ad-revenue/earnings
Authorization: Bearer sk_sandbox_...

{
  "shares": [
    {
      "id": "share_1a2b...",
      "payment_id": "pay_9f2a...",
      "ad_id": "ad_7c31...",
      "partner_amount_usd": 140.0,
      "platform_amount_usd": 60.0,
      "status": "paid",
      "payable_after": "2026-08-03T00:00:00Z",
      "paid_at": "2026-08-05T10:12:00Z"
    }
  ],
  "total_payable_pending_usd": 0.0,
  "total_payable_usd": 0.0,
  "total_processing_usd": 0.0,
  "total_paid_usd": 140.0
}

ప్రతి ప్రకటనకర్త ఖాతాకు అంతర్నిర్మిత AI సాధనాల సెట్ లభిస్తుంది — ఒక ప్రకటన కంటెంట్ మరియు విజువల్ జనరేటర్, ఒక సంభాషణా సహాయకుడు, ఒక బడ్జెట్ సలహాదారు, మరియు ఒక బాహ్య SEO ఆడిటర్ — ఫ్లాట్ వార్షిక ధరకు అదనంగా, AI క్రెడిట్‌లతో చెల్లించబడతాయి.

ఉదాహరణ — ప్రకటన కంటెంట్‌ను రూపొందించండి

అదే వర్గం మరియు వ్యాపార వివరణ కింద ఉన్న చిత్ర జనరేటర్‌కు కూడా శక్తినిస్తాయి.

POST https://api.adhub365.com/v1/advertisers/{advertiser_id}/ai/creative-studio
Authorization: Bearer <session access token>
Content-Type: application/json

{
  "category_name": "Furniture",
  "business_description": "We sell handmade oak dining tables"
}

{
  "title": "Handmade Oak Dining Tables — Built to Last",
  "description": "Solid oak dining tables crafted by hand, built to last a lifetime.",
  "keywords": ["oak furniture", "dining table", "handmade"],
  "credits_remaining": 8
}

అదే ప్రకటనకు సరిపోయే దృశ్యాన్ని రూపొందించండి:

POST https://api.adhub365.com/v1/advertisers/{advertiser_id}/ai/creative-studio/image
Authorization: Bearer <session access token>
Content-Type: application/json

{
  "category_name": "Furniture",
  "business_description": "We sell handmade oak dining tables"
}

{
  "visual_url": "https://cdn.uploadscenter.com/file_01m1...",
  "credits_remaining": 4
}

మీ సొంత సైట్‌లో రెడీ-మేడ్ యాడ్ యూనిట్‌ను డ్రాప్ చేయండి — నిర్మాణ దశ లేదు, ఇఫ్రేమ్ లేదు. ఈ స్క్రిప్ట్ ఒక ప్రత్యేకమైన షాడో DOM లోపల పేజీలో నేరుగా రెండర్ అవుతుంది, కాబట్టి దాని స్టైల్స్ మీ సైట్‌లోకి ఎప్పుడూ వ్యాపించవు, మరియు మీ సైట్ యొక్క స్టైల్స్ దానిలోకి ఎప్పుడూ వ్యాపించవు.

దాన్ని మీ పేజీకి జోడించండి

<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-count="4"
  data-columns="2"
></div>
<script async src="https://adhub365.com/widget.js"></script>

డిఫాల్ట్‌గా ఇది కేటగిరీకి పూర్తి పబ్లిక్ ర్యాంకింగ్‌ను చూపుతుంది — ప్లాట్‌ఫారమ్‌లోని ప్రతి యాడ్వర్టైజర్‌ను, మీరు తీసుకువచ్చిన వాళ్ళను మాత్రమే కాదు. కనెక్ట్ మోడ్ ద్వారా మీరు సృష్టించిన యాడ్వర్టైజర్ల నుండి వచ్చే యాడ్స్‌ను మాత్రమే చూపించడానికి (అంటే మీ వాటాను సంపాదించి పెట్టేవి), మీ పార్టనర్ IDతో data-partnerను జోడించండి (దాన్ని మీ స్వంత డాష్‌బోర్డ్‌లోని డెవలపర్స్ పేజీలో కనుగొనండి):

<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-partner="YOUR_PARTNER_ID"
></div>
<script async src="https://adhub365.com/widget.js"></script>

మీ ప్రకటనదారులు అనేక కేటగిరీలలో ఉంటే, data-categoryని పూర్తిగా వదిలేయండి — కేవలం data-partnerతో, ప్రతి కేటగిరీకి ఒక విడ్జెట్ బ్లాక్ అవసరం కాకుండా, మీ అన్ని కేటగిరీలలోని మీ ప్రకటనలన్నింటినీ ఒకే గ్రిడ్‌లో విడ్జెట్ చూపుతుంది:

<div
  class="annualads-widget"
  data-geo="global"
  data-partner="YOUR_PARTNER_ID"
></div>
<script async src="https://adhub365.com/widget.js"></script>

మీ కంటెంట్ లోపల ఉన్న యూనిట్‌కు సమాంతరంగా, వేర్వేరు ప్రకటనలను చూపించే ఫుటర్-శైలి యూనిట్‌ను కోరుకుంటున్నారా? మీ మొదటి విడ్జెట్ ఇప్పటికే ఎన్ని ప్రకటనలను చూపిస్తుందో ఆ సంఖ్యకు data-offset ను సెట్ చేసి, data-layout="compact" (ఒకే ప్రకటన, ఒక చిన్న పిల్‌గా కుదించగలది) తో రెండవ విడ్జెట్ బ్లాక్‌ను జోడించండి:

<!-- in your content -->
<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-count="4"
  data-columns="2"
></div>

<!-- in your footer, showing different ads via data-offset -->
<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-layout="compact"
  data-offset="4"
></div>
<script async src="https://adhub365.com/widget.js"></script>

లక్షణాలు

ఒక భాగస్వామి యొక్క రిఫరల్ కమీషన్ వాస్తవానికి వారికి ఎలా చేరుతుంది — శాతం, చెల్లింపు విధానం, మరియు ముందస్తు షరతులు.

GET https://api.adhub365.com/v1/referral-program

{
  "levels": [
    {
      "level": 1,
      "percentage": 0.1
    }
  ],
  "leaders_pool_percentage_of_gmv": 0.05,
  "founding_advertiser_pool_percentage_of_gmv": 0.05,
  "payout_verification_window_hours": 48,
  "min_payout_usd": 1
}

చెల్లింపు షరతులు

• ప్రకటనదారుడి మొత్తం చెల్లించదగిన ఆదాయం కనీస చెల్లింపు మొత్తానికి చేరుకుంటుంది.
• వారి ఖాతాలో క్రిప్టో చెల్లింపు వాలెట్ కాన్ఫిగర్ చేయబడింది.
• వారి KYC స్థితి ధృవీకరించబడింది.

ఉదాహరణ: పేరుకుపోయిన సంపాదనను చదవడం

GET https://api.adhub365.com/v1/partner/referrals/{code}/earnings
Authorization: Bearer sk_sandbox_...

{
  "code": "ann-2f8c",
  "earnings": [
    {
      "id": "earn_1a2b...",
      "payment_id": "pay_9f2a...",
      "amount_usd": 30.0,
      "status": "paid",
      "payable_after": "2026-08-01T00:00:00Z",
      "paid_at": "2026-08-03T14:22:00Z"
    }
  ],
  "total_payable_pending_usd": 0.0,
  "total_payable_usd": 0.0,
  "total_processing_usd": 0.0,
  "total_paid_usd": 30.0
}

ధరల స్థాయిలు (లైవ్)

ఈ ఎండ్‌పాయింట్ నుండి నేరుగా చదవండి — ఈ విలువలను ఎప్పుడూ హార్డ్‌కోడ్ చేయవద్దు, అవి మా వైపు నుండి మారవచ్చు. ఉచిత మొత్తం ఫీల్డ్‌కు బదులుగా మీ స్వంత వినియోగదారుల కోసం ఒక టైర్ పికర్‌ను నిర్మించండి: ఇక్కడ చూపిన ప్రతి ధర, చెల్లింపును సృష్టించేటప్పుడు పంపవలసిన ఖచ్చితమైన మొత్తం, మరియు ఇక్కడ చూపిన అన్‌లాక్ చేయబడిన ప్రయోజనాలు ఆ ధరతో వారికి ఏమి లభిస్తుందో వినియోగదారులకు ఖచ్చితంగా తెలియజేస్తాయి, తద్వారా వారు ఒక సంఖ్యను ఊహించడానికి బదులుగా తమకు అర్థమయ్యే ధరను ఎంచుకుంటారు.

ప్రతి కీకి, ప్రతి నిమిషానికి అభ్యర్థనలు పరిమితం చేయబడ్డాయి. ప్రతి ప్రామాణీకరించబడిన ప్రతిస్పందనలో X-RateLimit-Limit, X-RateLimit-Remaining, మరియు X-RateLimit-Reset హెడర్‌లు ఉంటాయి; పరిమితిని దాటినప్పుడు Retry-After హెడర్‌తో 429 Too Many Requests అనేది తిరిగి ఇవ్వబడుతుంది.

ఐచ్ఛికం, ప్రతి భాగస్వామికి. మీరు ఒక ఎంట్రీని జోడించే వరకు, మీ కీలు ఏ IP నుండి అయినా అభ్యర్థనలను అంగీకరిస్తాయి — మొదటి ఎంట్రీ ఆ భాగస్వామి యొక్క కీలన్నింటినీ కేవలం అలాయ్‌లిస్ట్‌కు మాత్రమే మార్చివేస్తుంది.

ప్రతి వెబ్‌హుక్, సృష్టించిన సమయంలో ఒకసారి జారీ చేయబడిన రహస్యాన్ని ఉపయోగించి HMAC-SHA256 తో సంతకం చేయబడుతుంది — పेलోడ్‌ను విశ్వసించే ముందు సంతకాన్ని ధృవీకరించండి. సంబంధిత ప్రకటనదారుడిని కలిగి ఉన్న భాగస్వామికి మాత్రమే ఈవెంట్‌లు అందించబడతాయి.