Lurayirin qillqatanakapa

Sapa mayni mayiwiw imantat llawiampi chiqanchata, Autorización p'iqinchirinxa, Bearer esquema apnaqasa.

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

Juman API llavinakamax juman apnaqirinakamataki yatiyirinakan qillqanakap uñstayani ukhaxa (Connect modo — uñxatt'äta Authentication ukaxa), jumax uka yatiyirinakax yatiyäwinakapat pagapki uka qullqit mä chikata katuqta. Aka aynachan uñstki uka jaljtawix aka pachpa endpoint uksat jichhapuni ullañawa, janipuniw qillqatäpkiti, ukatxa taqpachaniw jaljatawa aka pankan aynacharu uñstki uka referral commission ukatxa.

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

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

Kunjamsa irnaqi

1. Juman Connect-mode ukan mayni yatiyirima, juman mayachasiwim tuqi mä yatiyäwitaki pagayi.
2. Yatiyäwix uñakipatawa ukat iyaw satawa — jupa pachpata, jan ukax jiwasan uñakipiri tamasampi.
3. Juman ch'iqimaxa, juman billeteramaruxa kikipa payllasiñatakiwa wakicht'ata, ukhamarakiwa aynachankir jaqichañ programa ukham lurasiri.

Phuqhañatak kamachinaka

• Mä cripto qullqi katuqañ billeteraxa juman masiman cuentapan wakicht'atawa.
• Jumanxa janiw KYC uñacht'ayañax wakiskiti — masiman qillqayasiwipax lurasitäna ukapachaw uñakipataxiwa.

Uñacht'äwi: Tantachata ch'iqinaka ullaña

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
}

Sapa yatiyir qillqatanxa, manqhan utt'ayat AI irnaqañanaka katuqi: mä yatiyäwi yänaka ukat uñstawinaka uñstayiri, mä aruskipäwi yanapiri, mä qullqi tuqita iwxiri, ukat mä anqäx SEO uñakipiri. Taqi akanakax AI kreditu-mpiw phuqhasi, sapa maran churat chika chanipat sipansa.

Uñacht'äwi — yatiyäwi qillqata luraña

Päpach kasta ukat qhatu qhanañchäwix aynachankir uñnaqa luririrus ch'amancharakiwa.

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
}

Uka pachpa yatiyäwitakix mä uñtasir uñacht'äwi luraña:

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
}

Mä wakichat yatiyäwi t'aqa juman web qamawimar uchantama — janiw lurañax utjkiti, janiw iframe-s utjkiti. Script-ax chiqakpachaw páhinaru mä sapa Shadow DOM manqhan uñacht'ayi, ukhamat jupan estilunakapax janipuniw juman qamawimarux chhaqhaniti, ukat juman qamawiman estilunakapax janipuniw ukarux chhaqhaniti.

Pankamar yapxatt'am

<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>

Qalltanxa, akax categoría ukan taqpach uñt'at sayt'awip uñacht'ayi — plataforman utjki uka taqpach yatiyirinaka, janiw jumax Connect tuqi apantkta ukanakakikiti. Connect tuqi uñstayawaykta uka yatiyirinakan yatiyawinakapaki uñacht'ayañatakixa (jumankir ch'iqt'awim uñstayapki ukanaka), data-partner ukampi masiman ID-pampi yapxatta (uka juman dashboard-aman Developers uka chiqan jikxatta):

<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>

Yatiyirinakamax walja kasta tamanakan utjchi ukhaxa, data-category uka taqpach apsuñamawa — data-partner ukampikiw widget ukax taqi kasta tamanakan yatiyirinakamax mä sapa rejillan uñacht'ayi, sapa kasta tamatakix mä widget bloque munañat sipana:

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

Contenidoman utjki uka maynïr uñacht'äwi tamamp chika, mayni ukhamaraki uñacht'äwi tama, sapa mayni mayja uñacht'äwinak uñacht'ayañapataki munasmati? Payïr widget tama yapxatt'am, data-layout="compact" (mä sapa uñacht'äwi, jisk'a piruru tukuyañjam) ukampi, ukatsti data-offset ukax nayrïr widgetamax qawqha uñacht'äwinakas uñacht'ayi ukarjam ucht'ata:

<!-- 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>

Chimpunaka

Kunjamasa mä yanapirin khitanitapat chinuqapax jupar puri — patakatuqita, qullqi churañ thakhi, ukat nayraqat phuqhañanakampi.

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
}

Phuqhañatak kamachinaka

• Yatiyirin taqpach phuqhañ qullqipax jisk'a phuqhañ qullqiruw puri.
• Jupanakan cuentapanxa mä cripto qullqi katuqañ billeteraw wakicht'ata.
• Jupanakan KYC uñt'atapax chiqanchatawa.

Uñacht'äwi: Tantachata qullqi ullaña

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
}

Chanitak patanak (Jakäwinkiri)

Aka endpoint-ta jichhapuni ullaña — janipuniw aka chimpunakxa qillqantañati, jiwasan tuqitxa mayjt'aspawa. Juman apnaqirinakamatakix mä patanak ajlliñ luräma, jan mä ch'usa qullqi qillqañ chiqawjat sipana: sapa uñacht'ayata chanix paylläwi lurañ pachan apayañatakix chiqapuniwa, ukatsti akan uñacht'ayata jist'arata askinakax apnaqirinakarux chiqapuniw yatiyi kunas uka chanimp jikxataspa, ukhamat jupanakax mä jakhu amuyt'añat sipanxa, mä chan ajllipxañapataki, kunatix amuyapki uk.

Mayiwinakaxa sapa llaviru, sapa minuturu sayt'ayatawa. Sapa chiqap uñt'at jaysäwixa X-RateLimit-Limit, X-RateLimit-Remaining, ukhamaraki X-RateLimit-Reset p'iqinchirinakaniwa; sayt'äwi jilxatasaxa 429 Too Many Requests ukham kutt'ayi, mä Retry-After p'iqinchirimpi.

Ajlliñataki, sapa masitaki. Mä qillqata yapxatkamaxa, llavayanakamax kawki IP-taki mayiwinaksa katuqapuniwa — nayrïr qillqatax uka masin taqi llavayanakapxa "allowlist-only" ukhamaruw mayjt'ayi.

Sapa webhook ukax HMAC-SHA256 ukampiw chimpuntata, ukax mä kutiki uñstayat imantatampi lurasi, uñstayat pachan — apayanit yatiyäwir iyawsañataki nayraqat chimpu chiqañchaña. Yatiyäwinakax uka yatiyirimp chikachata masirukiw apayasi.