API reference

The RAiN API is REST over HTTPS, returns JSON (or CSV), and is authenticated with a Bearer API key. Base URL: https://rain.com.ng

Authentication

Send your key as a Bearer token on every request:

Authorization: Bearer rain_live_xxxxxxxx

Keys are issued by the RAiN team and are scoped (see below). Keep them secret — never expose a key in client-side code.

Scopes

PUBLIC — PII-free directory data (no contact details).
PII — includes contact details; for approved partners. A PII key also satisfies PUBLIC endpoints.

A request needing a higher scope than your key returns 403.

Rate limits

60 requests per minute per key. Exceeding it returns 429 with a Retry-After header (seconds).

Endpoints

GET /api/public/providers · scope PUBLIC

List verified experts (PII-free). Query parameters:

service — taxonomy service code
industry — taxonomy industry code
city — location contains
q — free-text search
format — json (default) or csv
limit — 1–500 (default 100)

curl "https://rain.com.ng/api/public/providers?city=Lagos&limit=20" \
  -H "Authorization: Bearer rain_live_xxx"

{
  "count": 1,
  "providers": [
    {
      "id": "…",
      "displayName": "…",
      "primarySkill": "…",
      "services": ["Customer support"],
      "industries": ["Hospitality"],
      "city": "Lagos",
      "tier": "VERIFIED",
      "completedProjects": 3,
      "rating": 4.8,
      "ratingCount": 5
    }
  ]
}

GET /api/private/providers · scope PII

As above, plus contact details (full name, email, phone, WhatsApp).

GET /api/private/businesses · scope PII

Business records including contact details, for approved partners.

Errors

401 — missing/invalid/revoked key
403 — key lacks the required scope
429 — rate limit exceeded (see Retry-After)

Get a key

Keys are issued by the RAiN team. Request access →