How to onboard your AI vendor on AgentExample
If you run an AI model API and want to be listed on AgentExample's /models directory, here's what we need from you and what the workflow looks like.
This post is for vendor-side folks — if you run an AI model API and you'd like to be listed on AgentExample, here's how.
What we need from you
- Public pricing visible without login (or a free tier that exposes the per-token rate). Buyers want to compare without signing up to 20 sites.
- OpenAI / Anthropic compatible API (or document a clear migration path). We link to your docs prominently.
- A real, public-facing product that has been live for at least 3 months.
- A press kit or logo asset at a stable URL (or we can use your
og:image). - (Optional) An author-affiliate program that we can join as a real account, not a scraped URL. Skip this if you don't have one.
What we don't need
- ❌ Payment or sponsorship — we list vendors regardless of affiliate status
- ❌ A pre-existing relationship — anyone can submit
- ❌ Any exclusivity — being on AgentExample doesn't prevent you from being on other directories
The workflow
After you submit (see below), here's what happens:
- Triage (1-2 days) — we check the 5 required items above
- Crawl (3-8 minutes) — we open your homepage + subscription page in a headless browser, extract your hero h1/h2, plan tier names + prices, logo, and entry-point URLs
- Write 4 files (one per vendor, follows our template):
src/content/models/<slug>.{en,zh}.mdx(frontmatter + 200-400 word prose body in both languages)references/providers/<slug>.md(our internal source-of-truth doc for refreshes)public/models/<slug>.<ext>(logo)
- Per-vendor commit — the diff is self-contained and can be reverted independently. No batch commits that mix your vendor with someone else's.
- Verify — vitest 25+ invariants pass,
pnpm buildexits 0, security-scan clean - Push + deploy — once you OK the MDX draft, we commit to the repo, push, and the next Cloudflare deploy ships your vendor live to https://agentexample.com
Total time: 15-30 minutes per vendor.
How to submit
Open a ticket with:
- Your product name + homepage URL
- A 1-line description ("AI model API with X special sauce")
- (Optional) Your affiliate program details — if you have one, we'll join through the official channel
What we will and won't change
After your vendor is live, we'll only change the MDX with:
- ✅ Add / update plans[] when your pricing changes (we re-crawl monthly, on your announcement, or when a user reports a stale page)
- ✅ Update referralUrl when you rotate your affiliate program
- ✅ Delete if you shut down, get acquired, or ask us to remove the listing
We will never silently change your pricing to make us look better or worse, or remove you because a competitor complained. Listings are content, not politics.
Maintenance cadence
- We re-crawl your vendor page every 90 days minimum
- We re-crawl immediately if you announce a pricing change
- We re-crawl on user feedback (someone reports a stale number)
If you want to skip our crawling and just send us the changes yourself, we accept that too — open a ticket with the diff.
What if I don't want to be listed?
Open a ticket requesting removal. We honor all removal requests within 24 hours, no questions asked.
Why we built this
Because the AI vendor space moves fast and the existing directories either:
- Are out of date (last updated 6+ months ago)
- Are pay-to-play (only premium vendors get listed prominently)
- Are affiliate-scraped (the URL is some other site's, not yours)
We want a directory that's:
- Current
- Open (any vendor meeting the bar can be listed)
- Affiliate-honest (every "Refer" link is the site owner's real one)
If that's the kind of directory you want to be on, submit. If not, that's fine too.