Adsourcer Developer

Build with Adsourcer

Adsourcer is the API layer for sponsored recommendations in AI apps. Publishers retrieve relevant ads; advertisers run campaigns — all through one infrastructure.

How it works

A user message flows through intent parsing, semantic retrieval, relevance ranking, and second-price auction logic. When commercial intent is detected, your app receives structured ad objects with mandatory disclosure metadata.

  1. Your app sends the conversation context to POST /v1/ads/recommend
  2. Adsourcer returns ranked candidates or a NO_AD decision
  3. You render the UI — Adsourcer never injects markup
  4. Users click through signed click_url redirects for attribution

Choose your path

Publishers

Integrate recommendations into chatbots, agents, and copilots.

Advertisers

Create campaigns, upload products, and manage budget.

SDKs

TypeScript and Python clients with typed helpers.

API reference

REST endpoints, request shapes, and response fields.

Base URL

All public endpoints use the /v1/ prefix. Local development defaults to http://localhost:8000.

Interactive API explorer

When the API is running, OpenAPI docs are available at http://localhost:8000/docs.

Support