oEmbed (auto-embed)

Ardent is an oEmbed provider. When you paste a link to a campaign, petition, event, profile, blog post, or marketplace listing into a tool that supports oEmbed (Notion, Discord, Slack, and others), it renders as a live, sandboxed card instead of a plain link — the same widgets described in Widgets, with no code to copy.

Endpoint

https://ardent.africa/api/oembed?url=<encoded-ardent-url>&format=json

Each canonical page also advertises this endpoint with a discovery tag, so most consumers find it on their own:

<link rel="alternate" type="application/json+oembed"
      href="https://ardent.africa/api/oembed?url=...&format=json" />

Supported URLs

Paste a link like	Renders as
`https://ardent.africa/campaign/<slug>`	campaign or petition card
`https://ardent.africa/events/<slug>`	event card
`https://ardent.africa/supporter/<username>`	supporter impact badge
`https://ardent.africa/blog/<slug>`	blog post card
`https://ardent.africa/marketplace/<id>`	listing card

Any other URL returns 404 — the provider only resolves Ardent content URLs.

Example

curl "https://ardent.africa/api/oembed?url=https%3A%2F%2Fardent.africa%2Fcampaign%2Fclean-water-for-tamale"

{
  "version": "1.0",
  "type": "rich",
  "provider_name": "Ardent Africa",
  "provider_url": "https://ardent.africa",
  "title": "Clean water for Tamale",
  "thumbnail_url": "https://.../image.jpg",
  "width": 420,
  "height": 340,
  "html": "<iframe src=\"https://docs.ardent.africa/embed/campaign/clean-water-for-tamale\" ... sandbox=\"allow-scripts allow-popups\"></iframe>",
  "cache_age": 60
}

Pass maxwidth / maxheight to cap the dimensions.

WordPress

WordPress only auto-embeds providers it knows about. The official Ardent Africa WordPress plugin (coming soon) registers Ardent as a provider so pasted links just work; until then, use the iframe or script embed on WordPress. Discovery-based consumers (Notion, Discord, etc.) work today.

Safety

The response is always type: rich with a sandboxed iframe (no allow-same-origin) — it cannot read the host page, takes no payments, and only deep-links back to ardent.africa for any action. The provider never fetches the URL you pass; it resolves the resource through the public API.

Last updated: 28 June 2026