Annual Ads

Documenta programmatum

Construite directe in suggestu "Annual Ads" — creatis praecones, publicatis praeconia, excitatis solutiones, et vestigatis ordinem, omnino per API.

Vide totam tabulam pretiorum.

Tu 70% retines. Quod praecones tui in modo Connexo pro praeconiis suis solvunt, sponte in crumenam tuam solvitur. Infra vide quomodo operetur.

URL fundamentale

https://api.adhub365.com
OpenAPI 3

Authenticatio

Omnis petitio clavis secreta in capite auctoritatis comprobatur, adhibito schemate possessoris.

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

Spatium Experimentale et Productio

Claves et experimentales et productivae inter se omnino seiunctae sunt — clavis enim experimentalis numquam data a clave productiva creata legere aut scribere potest, nec vice versa.

Scopuli

Quaeque clavis ad fines definitur sub quibus edita est — clavis numquam plus accessus habet quam ratio socia quae eam creavit.

Claves API rationibus sociorum probatis a turma Anuntiationum Anniversariarum emittuntur.

Rationem socii crea

Ad reditum ex praeconiis partiendum

Si claves API tuae rationes praeconum pro propriis utentibus creant (modo "Connect" — vide "Authentication" supra), partem meres eorum quae illi praecones pro praeconiis suis solvunt. Partitio infra ex eodem terminali vivo legitur, numquam in codice fixa, et omnino seiuncta est a commissione commendaticia quae postea in hac pagina invenitur.

GET https://api.adhub365.com/v1/partner-program
{
  "partner_share_percentage": 0.7,
  "platform_share_percentage": 0.3
}

70%

Ad te pertinet

Sponte in loculum solutionis tuum constitutum solutum — nulla petitio subtractionis requiritur.

30%

Ad Praeconia Annua Iit

Tractat de moderatione, hospitio, et infrastructura ordinationis in qua praeconia tua funguntur.

Quomodo fungatur

  1. Unus ex praeconebus tuis modo Connexus per integrationem tuam praeconium solvit.
  2. Praeconium recensetur et approbatur — sive sponte, sive a grege nostro moderatorum.
  3. Portio tua in ordine stat ad solutionem automaticam in crumenam tuam, eadem ratione ac programma commendaticum infra.
Portio numquam creatur antequam praeconium re vera approbatur — si moderatores id reiciunt, nihil ex illa solutione debetur. Additamentum autem in praeconium iam actum nullum tale periculum habet et statim dividitur.

Condiciones solutionis

  • Sarcina solutionis crypticae in ratione socii tui configuratur.
  • Nulla probatio identitatis tua requiritur — ratio socii tui iam in creatione probata est.

Exemplum: Lectio actionum coacervatarum

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
}

Extrema

Rationes

POST/v1/partner/advertisers

Crea rationem praecones pro uno ex utentibus tuis (modus Coniungendi).

advertisers:write
GET/v1/partner/advertisers/{id}

Quaere rationem praeconesis a hoc socio creatam.

advertisers:read

Praeconia

POST/v1/partner/ads

Creā praeconium. In statū prōiectī incipit. Campī optiōnāles 'advertiser_type', 'promotion_type', 'link_type', et 'promoted_brand' praeconium sociōrum, commendaticum, auctōrum, vel singulōrum dēfīniunt — vide nōtām infra.

ads:write
GET/v1/partner/ads/{id}

Quaere praeconium.

ads:read
PATCH/v1/partner/ads/{id}

Renova materiam editorialem — titulum, descriptionem, nexum, genus praeconesis, genus promotionis, genus nexus, et notam promotam. Categoria, geographia, et omnia quae a machina ordinandi leguntur hic numquam mutari possunt.

ads:write
POST/v1/partner/ads/{id}/image

Imaginem praeconii directe impone (JPEG/PNG/WebP, ad summum 5 MB). Requiritur ante primam solutionem — vide gregem solutionum infra.

ads:write
POST/v1/partner/ads/{id}/image-url

Imaginem praeconii ex URL constitue potius quam documentum imponere — servus ipse eam et petit et in hospitio ponit. Idem requisitum: ante primam solutionem necessarium.

ads:write
GET/v1/partner/ads/{id}/rank

Ordo, categoria, et ambitus geographicus praesens praeconii.

ads:read
GET/v1/partner/ads/{id}/stats

Summa conspectuum et pulsationum praeconii — dies elapsi/remanentes ex campis "activated_at" et "expires_at" iam in GET /{id} praebentur, et ordo ex GET /{id}/rank.

ads:read

Solutiones

POST/v1/partner/payments

Incipe solutionem cryptographicam pro emptione initiali aut pro supplemento. Solutio initialis cum errore 422 defert, nisi praeconium iam imaginem habet — vide uploadAdImage/setAdImageUrl supra.

payments:write
GET/v1/partner/payments/{id}

Statum solutionis comproba.

payments:read

Commendationes

POST/v1/partner/referrals

Crea nexum commendaticum.

referrals:write
GET/v1/partner/referrals/{code}/earnings

Summa quaestuum ex commendationibus cumulata, per statum distributa.

referrals:read

Ad reditus ex praeconiis communicandos

GET/v1/partner/ad-revenue/earnings

Pars tua septuaginta centesimarum (70%) ex iis quae praecones, quos in modo Coniuncto creavisti, pro praeconiis suis solverunt, per statum distributa.

ad-revenue:read

Registrum accessuum

GET/v1/partner/access-log

Historia plena vocationum huius clavis — methodus, via, inscriptio IP, nota temporis.

Ibi

Terminalia publica

GET/v1/rankings?category={id}&geo={scope}

Ordo solum legendus pro categoria et ambitu geographico.

Publicum
GET/v1/tiers

Septem gradus pretiorum configurati (limen, praemia reserata).

Publicum
GET/v1/referral-program

Percentus commissionum nunc vigentes pro catena commendationum et Piscina Ducum.

Publicum
GET/v1/partner-program

Partitio praesens redituum ex praeconiis (modo Coniuncto) inter te et Praeconia Annua.

Publicum
GET/v1/search?q={query}

Quaestio linguae naturalis — quaestionem, ut "mobilia praecones in Kenia," ad categoriam et ambitum geographicum congruentem dirigit, deinde illud ordinamentum eius ordine vero et exacto reddit.

Publicum

Praeconium Socii et Commendaticum

advertiser_type, promotion_type, link_type, et promoted_brand sunt campi optionales in POST et PATCH /v1/partner/ads — "Praeconia Annua" non solum negotiis se praedicantibus limitantur. Cum link_type est affiliate_link aut referral_invitation_link, aut promotion_type est affiliate_offer aut referral_opportunity, affiliate_terms_accepted verum esse debet, alioquin petitio errore 422 reicitur. Titulus ad triginta quinque litteras et descriptio ad octoginta coartantur — ambo ex parte servientis, non solum in interfacie usoris tabulae, coguntur.

Instrumenta Intelligentiae Artificialis

Cuique rationi praeclaritori tribuitur copia instrumentorum intellegentiae artificialis insitorum — generator rerum praeconialium et imaginum, adiutor colloquialis, consiliarius sumptuum, et auditor externus SEO — quae creditis IA solvuntur, praeter pretium annuum fixum.

Hi per accessum proprium tabulae instrumentorum praeconei (symbolum sessionis) funguntur, non per clavem API socii — integratio tertiae partis eos pro praeconio vocare non potest.
POST/v1/advertisers/{id}/ai/assistant

Ask Annual Ads — adiutor colloquialis mobilis, solum informativus, data rationis solum legens.

Publicum
POST/v1/advertisers/{id}/ai/creative-studio

Creā titulum, descriptiōnem, et verba clāvī ex brevī descriptiōne negōtiī.

2 fidem(es)
POST/v1/advertisers/{id}/ai/creative-studio/image

Creā imaginem indicem (PNG) ex eadem descriptione negotii, hospitata et parata ut adscribatur praeconio.

8 fidem(es)
POST/v1/advertisers/{id}/ai/budget-advisor

Verum proiectum statisticum — numquam coniectura generativa — probabilitatis retinendi certum ordinem diebus XXX/XC/CCCXC.

1 fidem(es)
POST/v1/advertisers/{id}/ai/seo-audit

Examina situm externum praeconis ipsius et suade emendationes SEO concretas.

2 fidem(es)

Exemplum — generā materiam praeconialem

Idem genus et descriptio negotii etiam machinam imaginum infra positam alunt.

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
}

Genera imaginem congruentem eiusdem praeconii:

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
}

Modulus

Pone unitatem praeconialem paratam in situ tuo — sine ulla constructione, sine iframe. Scriptura recta in paginam intra Shadow DOM seiunctum redditur, itaque stili eius numquam in situm tuum effluunt, et stili situs tui numquam in eam.

Adde id ad paginam tuam.

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

Per defaltam, hoc monstrat ordinem publicum plenum categoriae — omnes praecones in suggestu, non solum eos quos tu addidisti. Ut solum praeconia a praeconibus per modum "Connect" creatis monstrentur (qui partem tuam generant), adiunge "data-partner" cum ID socii tui (id inveni in pagina "Developers" tabulae instrumentorum tuae):

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

Si praecones tui per plures categorias patent, "data-category" omnino omitte — cum solo "data-partner", enim, modulus omnes praeconia tua per omnes categorias in una craticula monstrat, potius quam ut unum blocum moduli pro unaquaque categoria requiratur.

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

Visne unitatem in margine inferiore iuxta primam tuam in corpore textus, utramque diversa praeconia monstrantem? Adde secundum blocum instrumentorum cum proprietate "data-layout="compact" (unum praeconium, in pilulam parvam contrahibile) et proprietate "data-offset" ad numerum praeconiorum quem primum instrumentum iam monstrat accommodatam:

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

Proprietates

data-categoryID categoriae ad ostendendum. Necessarium — nisi "data-partner" definitur; quo definito, id omittere praeconia illius socii per omnes categorias ostendit.
data-geoGeo ambitus: localis, regionalis, an globalis. Defaultim globalis est.
data-countNumerus praeconiorum monstrandorum. Defectu ad quattuor stat.
data-columnsNumerus columnarum retis. Valor praedefinitus est 2.
data-layoutreticulata, elenchi, aut compacta. Praedefinitum est reticulata. Modus compactus unum tantum praeconium monstrat (numerus datorum neglegitur) cum globulo ad id in parvam pilulam contrahendum et reducendum — unitas ad modum pedis paginae, quae a scripto ipso numquam fixa ponitur; tu ipse receptaculum 'div' quomodo velis in pagina tua collocas et ornatas.
data-offsetNumerus praeconiorum praestantissimorum praetermittendorum. Valor praedefinitus est 0. Permittit alteri instrumento in eadem pagina (e.g. compacto in pede paginae et reticulato alio loco superiore) praeconia diversa monstrare potius quam idem bis iterare — traditur numerus praeconiorum quae alterum instrumentum iam monstrat.
data-partnerID socii tui (inveni in pagina "Programmatores" tabulae instrumentorum tuae). Ad libitum — sine eo, modulus indicem publicum plenum illius categoriae ostendit, omnes praecones in suggestu. Cum eo, solum praeconia praeconum quos per modum "Connect" adduxisti — eorum qui re vera partem tuam generant.

Vectigalium Partitio

Quomodo commissio socii ex commendatione re vera ad eum perveniat — pars pro centum, ratio solutionis, et praecondiciones.

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
}

Non numerus certus

Commissio pro centum ex parte nostra configuratur et mutari potest — semper eam vivam ex hoc terminali lege potius quam valorem in codice figendo.

Omnino automatus

Nullum est finis recessus. Opus praestitutum quaestus solvendos generat, eos per praeconem coagit, et automatice solvit, cum omnes condiciones infra datae impletae sunt.

Condiciones solutionis

  • Summa quaestuum solvendae praeconis ad summam minimam solutionis pervenit.
  • Sarcina solutionis crypticae in ratione eorum configuratur.
  • Status KYC eorum comprobatus est.

Exemplum: de reditu accumulato legendo

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
}

Gradus Pretiorum (vivus)

Ex hoc terminali vive lege — numquam has valores in codice dure inscribe, nam ex parte nostra mutari possunt. Crea selectorem graduum pro tuis utentibus potius quam campum summae gratuitae: unumquodque pretium monstratum iam est summa exacta mittenda cum solutio creatur, et beneficia reserata hic monstrata utentibus accurate indicant quid illud pretium eis praebeat, ut pretium quod intellegunt eligant potius quam numerum conicere.

gradusPretiumReserationes
Bronze$50.00

Basic visibility

Silver$300.00

Clickable link unlocked

Nexus pulsabilis
Gold$500.00

Animation unlocked

Nexus pulsabilisAnimātiō
Platinum$1,000.00

Enhanced exposure

Nexus pulsabilisAnimātiō
Diamond$2,500.00

Premium placement

Nexus pulsabilisAnimātiō
Elite$5,000.00

Top-tier visibility

Nexus pulsabilisAnimātiō
Legendary$10,000.00

Maximum visibility & branding

Nexus pulsabilisAnimātiō

Termini rationis

Petitiones per clavem per minutum limitantur. Omnis responsum authenticatum titulos X-RateLimit-Limit, X-RateLimit-Remaining, et X-RateLimit-Reset fert; si limitem exceditur, codex 429 "Nimis Multae Petitiones" cum titulo "Retry-After" redditur.

Index admittendorum IP

Ad libitum per socium. Donec inscriptionem addas, claves tuae petitiones ab omni inscriptione IP accipiunt; prima inscriptio omnes claves illius socii ad modum "tantum in indice permissorum" mutat.

Uncī Retī

Quisque webhook cum HMAC-SHA256 subscribitur, utendo secreto semel edito tempore creationis — subscriptio verificanda est antequam onus fidatur. Eventus solum socio traduntur qui praeconem cognatum possidet.

payment.succeededPecunia soluta est.
payment.refundedRemissio pecuniae fit.
ad.activatedPraeconium activum fit, sive automatice sive post moderationem administratoris.
invoice.issuedSyngrapha editur.
referral.payout.completedCommissio commendaticia statum solutum attingit.
referral.payout.failedSeries solutionum commendaticarum apud praebitorem deficit — quaestus ad solvendum redeunt et iterum conantur.
rank.changedOrdo praeconii mutatur, etiam cum solutio alterius praeconatoris id efficit.
ad.expiring_soonTriginta, septem, aut uno die antequam praeconium exspiraverit.
partner_ad_revenue.payout.completedSortitio reditus ex praeconiis statum solutae attingit.
partner_ad_revenue.payout.failedSeries solutionum partitionis redituum praeconiariorum apud praebitorem deficit — partes ad solvendum redeunt et denuo conantur.

Instrumenta ad Programma Evolvenda

SDK officialia JavaScript/TypeScript et Python, ex eadem hac API specificatione generata, parantur sed nondum eduntur — interim API HTTP directe invoca.

Initium Celer

Nondum SDK — hi API HTTP directe invocant et hodie in quolibet lingua operantur.

cURL

curl -X POST https://api.adhub365.com/v1/partner/ads \
  -H "Authorization: Bearer sk_sandbox_..." \
  -H "Content-Type: application/json" \
  -d '{"advertiser_id":"adv_9f2a...","category_id":"cat_furniture","geo_scope":"local","title":"..."}'

JavaScript

await fetch("https://api.adhub365.com/v1/partner/ads", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk_sandbox_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    advertiser_id: "adv_9f2a...",
    category_id: "cat_furniture",
    geo_scope: "local",
    title: "...",
  }),
});

Python

import requests

requests.post(
    "https://api.adhub365.com/v1/partner/ads",
    headers={"Authorization": "Bearer sk_sandbox_..."},
    json={
        "advertiser_id": "adv_9f2a...",
        "category_id": "cat_furniture",
        "geo_scope": "local",
        "title": "...",
    },
)