API Documentation

Access real-time Nigerian commodity price data programmatically.

Overview

The NaijaMarket Intel API provides RESTful access to verified commodity price data across 226+ Nigerian markets covering 610+ food commodities. Data is updated multiple times daily through our crowdsourced trader network with 3-validator consensus verification.

Base URL

https://func-naijamarket-api.azurewebsites.net/api

Endpoints

GET/health

Check API status and version.

GET/prices/lookup?item=rice&market=mile+12

Look up current prices for a specific item and optional market.

Parameters:

item (required) — commodity name (e.g., rice, tomatoes, palm oil)
market (optional) — market name filter
state (optional) — state filter (e.g., Lagos, Anambra)
limit (optional) — max results (default: 20)

GET/prices/markets?market=mile+12

Get all current prices for a specific market.

GET/arbitrage?item=rice&min_spread=5

Find price differences for the same commodity across markets.

GET/morning-brief/preview?type=OVERVIEW

Preview today's Morning Brief content.

Authentication

Public endpoints (health, price lookup) require no authentication. Protected endpoints require an API key passed as a query parameter:

GET /api/prices/lookup?item=rice&code=YOUR_API_KEY

API keys are available on CORPORATE and ENTERPRISE subscription tiers. Contact api@naijamarketintel.com for enterprise access.

Rate Limits

Tier	Requests/Hour	Requests/Day
FREE	10	50
CORPORATE	500	5,000
ENTERPRISE	5,000	50,000

Response Format

All responses are JSON with the following structure:

{
  "status": "success",
  "count": 15,
  "data": [...],
  "duration_ms": 42
}