Developers

Organic Global Trade API

A simple read-only REST API for our catalogue of products, categories and suppliers.

Authentication

Every request needs an API key, issued by our team. Send it in the X-API-Key header (preferred) or as an ?api_key= query parameter.

curl -H "X-API-Key: YOUR_KEY" https://www.organicglobaltrade.com/public/api/v1/products

Endpoints

GET https://www.organicglobaltrade.com/public/api/v1/products

List and search products. Query params: q, category (slug), sort (price_low, price_high, newest), page, per_page (max 50).

GET https://www.organicglobaltrade.com/public/api/v1/products/{slug}

Fetch a single product by its slug, including the full description.

GET https://www.organicglobaltrade.com/public/api/v1/categories

List all active categories with their parent relationships.

GET https://www.organicglobaltrade.com/public/api/v1/suppliers

List public supplier profiles. Query params: q, state, page, per_page.

Example response

{
  "data": [
    {
      "id": 1,
      "name": "Organic Basmati Rice",
      "slug": "organic-basmati-rice",
      "price": 120.0,
      "currency": "INR",
      "unit": "kg",
      "category": "Grains & Cereals",
      "supplier": { "name": "Narmada Organics", "verified": true },
      "url": "https://www.organicglobaltrade.com/public/product/organic-basmati-rice"
    }
  ],
  "meta": { "page": 1, "pages": 3, "total": 28, "per_page": 20 }
}

Need a key? Get in touch and we'll set you up.