Developer portal

One API for ANY Opportunity

Get programmatic access to curated jobs, scholarships, training programmes and tenders. Straight from the source, no unnecessary middlemen.

Getting started

1. 1

   Create an account

   Sign in with the same account you use on Chance AI.
2. 2

   Issue an API key

   Generate a key from the API keys page. It is shown once and cannot be recovered.
3. 3

   Call the API

   Send the key as a bearer token on every request. Anonymous requests still work but are limited per IP address.

Your first request

Export your key as CHANCE_API_KEY and fetch two job listings. The same bearer token works on every endpoint in the reference.

curl -sS "https://api.chance.africa/api/v1/jobs?limit=2" \
  -H "Authorization: Bearer $CHANCE_API_KEY" \
  -H "Accept: application/json"

Quotas and limits

Requests carrying a valid key draw down a monthly allowance of 1 000 requests that resets at the start of each calendar month in UTC. Requests without a key fall back to a smaller per-IP limit.

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 987
X-RateLimit-Reset: 1767225600

Once the allowance is exhausted the API responds with 429 Too Many Requests and a Retry-After header. Track your current usage on the API keys page.

Model Context Protocol

The same catalogue is available to AI agents as MCP tools. It is a read-only JSON-RPC endpoint that takes the same API key as the REST API.

Machine readable spec

The API is described by an OpenAPI 3.1 document you can feed into your own client generator.