AfriHarvex Developers

Public read-only API and embed widgets. Build your own integrations against AfriHarvex storefronts — no auth required, no API key, no rate limits beyond standard Vercel edge protections.

🔓 PublicNo auth, no key. CORS open from any origin.

⚡ Edge-cached2-min freshness on JSON, 5-min on embeds. SWR fallback up to 24h.

📦 Stable shapeVersioned at /api/v1/. Future shape changes ship under /v2.

🏆 Empire dataLoyalty tier + aggregator status surfaced on every response.

Quick start: drop this anywhere on your website to show an AfriHarvex storefront card →

<iframe src="https://afriharvex.com/embed/storefront/<slug>"
        width="320" height="460" frameborder="0"
        style="border:0;border-radius:14px"></iframe>

📡 JSON API

Storefront · GET CORS 120s

/api/v1/storefront/<slug> — fetch a single storefront + its 50 most recent active listings.

# curl example
curl https://afriharvex.com/api/v1/storefront/jamsrock

# Response (200)
{
  "storefront": {
    "id": "f74be819-716b-4ed8-a766-178910ff3e9b",
    "slug": "jamsrock",
    "name": "Jamsrock",
    "industry": "Agriculture",
    "country": "Nigeria",
    "about": "We buy and sell",
    "logo_url": null,
    "cover_url": null,
    "verified": false,
    "loyalty_level": "bronze",    // bronze | silver | gold | platinum | diamond
    "is_aggregator": false,        // 20%-commission agent flag
    "url": "https://afriharvex.com/biz/jamsrock",
    "created_at": "2026-05-04T04:49:28.599764+00:00"
  },
  "listings": [
    {
      "id": "afa57af4-...",
      "name": "One crate of egg",
      "price": 6400,                 // major units (₦, not kobo)
      "currency": "NGN",
      "unit": "crate",
      "qty": 1,
      "category": "livestock",
      "image_url": "https://...supabase.co/.../crate.jpg",
      "ships_internationally": false,
      "delivery_fee": 0
    }
  ],
  "meta": {
    "api_version": "v1",
    "listing_count": 1,
    "fetched_at": "2026-05-26T22:30:00.000Z"
  }
}

Field	Type	Notes
`storefront.loyalty_level`	string	One of `bronze · silver · gold · platinum · diamond`
`storefront.is_aggregator`	bool	True = seller earns 20% on agent-sourced deals
`storefront.verified`	bool	KYC-verified business
`listings[].price`	number	Major units (₦, not kobo). Divide cents by 100 already done.
`listings[].ships_internationally`	bool	If false, only ships within seller's country

Error responses: 404 {"error":"storefront not found"} for unknown / suspended slugs. 400 {"error":"invalid slug"} for malformed input.

🧩 Embed Widget

Storefront card · GET 300s

/embed/storefront/<slug> — drop-in iframe with logo, name, verified pill, loyalty + aggregator chips, 3 top listings, and a "View on AfriHarvex →" CTA.

<!-- 320×460 card, suggested dimensions -->
<iframe src="https://afriharvex.com/embed/storefront/jamsrock"
        width="320" height="460"
        frameborder="0"
        style="border:0;border-radius:14px"></iframe>

Click any part of the card opens the live storefront at /biz/<slug> in a new tab. Iframe-safe (frame-ancestors *) so it embeds anywhere — WordPress, Shopify, blogs, Notion, anywhere.

🎨 Brand skin params

Both embed widgets (/embed/storefront/<slug> and /embed/listing/<id>) accept optional query params so the card matches your own site. All are validated server-side — invalid values fall back to the default, so a bad param never breaks the widget.

Param	Values	Effect
`accent`	6-digit hex (`%23c20e0e` or `c20e0e`)	Primary color — CTA, price, verified pill.
`theme`	`light` · `dark` (default)	Light or dark card palette.
`logo`	https URL	Override the card logo (storefront widget only).
`radius`	0–24 (default 14)	Corner radius in px.
`chrome`	`min`	Hide the "Powered by AfriHarvex" footer line. (The View/Buy CTA always stays.)

<!-- brand-matched: red accent, light, rounded, minimal chrome -->
<iframe src="https://afriharvex.com/embed/storefront/jamsrock?accent=%23c20e0e&theme=light&radius=10&chrome=min"
        width="320" height="460" frameborder="0" style="border:0"></iframe>

Sellers: grab your own embed snippet inside Profile → Dashboard → 📱 QR & embed code.

🗺️ Sitemap

/sitemap.xml — dynamic, enumerates every public non-suspended storefront slug. Rebuilds every hour at the edge. Use this for SEO crawler hints if you mirror or index AfriHarvex content.

🔐 What you'll never see in the API

The public surface is intentionally narrow. Anything that could identify or contact a user is filtered out at the function head:

No email · phone · wallet_balance · KYC docs · trust score internals
No buyer_id · seller_id on the public endpoints — only the storefront identity
No deal ledgers, payment refs, or admin tables

🚀 Coming next

Public top-earners JSON endpoints (top referrers · agents · loyalty)
Listing-detail embed widget (single product card)
OAuth-scoped private API for partners (signed read access to own deals)

Questions? Bugs? Tag @afriharvex or open an issue. We ship the empire daily.