OppsRadar API

Base URL

All endpoints are served over HTTPS. Requests over plain HTTP are not supported.

Authentication

Pass your API key as a Bearer token in the Authorization header on every request to the /api/v1/* endpoints.

CopyGET /api/v1/opportunities HTTP/1.1
Host: oppsradar.com
Authorization: Bearer ordk_your_api_key_here

Key format

Keys follow the format ordk_<40 hex chars>, e.g.:

ordk_3f8a12b9c74e21d05a6f8b3c19e4d2a70f5c6b8e

Getting a key

Visit oppsradar.com → For Developers, fill in your name and email, and your free key will be shown on screen immediately and only once. Store it somewhere safe — it cannot be retrieved again.

Quick start

Step 1 — Get your free API key

Go to oppsradar.com → For Developers and fill in the form. Your key appears instantly.

Step 2 — Make your first request

Copycurl https://oppsradar.com/api/v1/opportunities \
  -H "Authorization: Bearer ordk_your_key_here"

Step 3 — Filter the results

Copycurl "https://oppsradar.com/api/v1/opportunities?type=Scholarship&country=Nigeria&limit=20" \
  -H "Authorization: Bearer ordk_your_key_here"

Step 4 — Parse and build

Copy// Browser / ES module example
const res = await fetch(
  'https://oppsradar.com/api/v1/opportunities?type=Scholarship&limit=10',
  { headers: { Authorization: 'Bearer ordk_your_key_here' } }
)
const { opportunities, meta } = await res.json()

console.log(`Loaded ${opportunities.length} results`)
console.log(`Used ${meta.daily_requests_used} of ${meta.daily_limit} requests today`)

Endpoints

CopyGET /api/v1/opportunities?type=Scholarship&country=Nigeria&limit=20
Authorization: Bearer ordk_your_key_here

CopyGET /api/v1/opportunities?type=Internship&field=Engineering
Authorization: Bearer ordk_your_key_here

Copycurl -X POST https://oppsradar.com/api/developer/signup \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Adaeze Okonkwo",
    "email": "adaeze@example.com",
    "use": "Building a Telegram bot for my university community"
  }'

Copy{
  "ok": true,
  "message": "Your free API key has been created. Save it now — it is shown only once.",
  "api_key": "ordk_3f8a12b9c74e21d05a6f8b3c19e4d2a70f5c6b8e",
  "key_prefix": "ordk_3f8a12b",
  "tier": "free",
  "daily_limit": 20,
  "docs": "https://oppsradar.com/docs"
}

Copycurl https://oppsradar.com/api/opportunities

Response shape

Opportunity object

Meta object (only in /api/v1/ responses)

Full response example

Copy{
  "opportunities": [
    {
      "id": 1,
      "title": "Erasmus Mundus Joint Masters",
      "organization": "European Commission",
      "type": "Scholarship",
      "description": "Prestigious EU-funded scholarship for international Masters study.",
      "eligibility": "Graduates from non-EU countries",
      "countries": "International",
      "fields": "All fields",
      "level": "Masters",
      "deadline": "2025-02-15",
      "funding": "Fully funded",
      "application_url": "https://erasmus-plus.ec.europa.eu",
      "verified": 1
    }
  ],
  "meta": {
    "count": 1,
    "tier": "free",
    "daily_requests_used": 3,
    "daily_limit": 20
  }
}

Error codes

Error response shape

Copy{
  "error": "Daily limit of 20 requests reached for your free plan. Upgrade at oppsradar.com/developers",
  "limit": 20,
  "used": 21,
  "tier": "free"
}

Rate limits

Limits are per API key, per UTC calendar day. The counter resets at 00:00 UTC.

The current usage is returned in every response inside the meta object so you can track it programmatically.

Pricing & plans

How to upgrade

Paid plans are processed via Paystack. Visit the upgrade section on the Developers page, pick your plan, and complete the Paystack checkout. Your key is upgraded within seconds — no new key needed.

Examples

JavaScript — Fetch API

Copyconst API_KEY = 'ordk_your_key_here'

async function getScholarships(country = 'Nigeria') {
  const params = new URLSearchParams({
    type: 'Scholarship',
    country,
    limit: '20',
  })

  const res = await fetch(
    `https://oppsradar.com/api/v1/opportunities?${params}`,
    { headers: { Authorization: `Bearer ${API_KEY}` } }
  )

  if (!res.ok) {
    const err = await res.json()
    throw new Error(err.error)
  }

  return res.json()
}

// Usage
const { opportunities, meta } = await getScholarships()
console.log(opportunities)   // array of opportunity objects
console.log(meta)            // { count, tier, daily_requests_used, daily_limit }