API Beta

Every page for sale, with its real numbers, as JSON.

The same verified audience the site shows (views, the Google searches behind them, 12 months of history, prices), readable by your code or your AI agent. Public endpoints need no key.

Try it

curl "https://adsworn.com/api/v1/pages?q=video+editing&intent=buying"

Or open it: https://adsworn.com/api/v1/pages?q=video+editing&intent=buying

Endpoints

  • GET /api/v1/pages

    Pages and videos for sale, ranked like /browse.

    Params: q, format=featured|banner, intent=buying, views (min), price (max, USD), niche, type=video, page

  • GET /api/v1/pages/{id}

    One listing: audience, searches, 12-month history, trend, estimate, prices, booking links.

  • GET /api/v1/sites/{domain}

    A publisher's storefront: every page for sale on that site.

  • GET /api/v1/bounties

    What sponsors have put up right now: the pledge and every open bounty.

  • GET /api/v1/mekey

    Your sites with their audience, and your sponsorships sold and bought.

Your key

Make one in your account and send it as a header. It reads only your own sites and sponsorships; revoke it there any time.

curl https://adsworn.com/api/v1/me \
  -H "Authorization: Bearer adw_k_…"

What you get, and the rules

  • Real numbers only. Audience figures are read from the publisher’s own Google Search Console, Google Analytics or YouTube Analytics, read-only. The one estimate (next 4 weeks) is labelled as one.
  • Fresh. Public responses are cached for 5 minutes; the numbers behind them refresh daily from Google.
  • Read-only, for now. Booking goes through the listing links in each response, so the publisher’s approval and the payment hold stay exactly as on the site. Write endpoints come when people ask for them.
  • Beta. Shapes can gain fields; existing fields won’t change meaning without a new version path. No rate limit yet beyond fair use.
  • Say where it came from. If you republish a number, link the listing it came from.

Also machine-readable

/inventory.json (every page, paged) and /llms.txt (what AdSworn is, for assistants). Want something the API doesn’t do yet? Tell us.