ReliefWeb API
The ReliefWeb API gives you programmatic access to humanitarian reports, disasters, jobs, training, and related data as JSON over HTTPS.
Start here
Choose what you want to do. Both paths require an approved appname on every request:
Search and retrieve reports, disasters, jobs, training, countries, and sources.
Appname
Every API URL needs a pre-approved appname so ReliefWeb can monitor usage. Pass it as a query parameter on the URL (including for POST, PATCH, or DELETE requests):
https://api.reliefweb.int/v2/reports?appname=YOUR-APPROVED-APPNAME
Request one with this short form. Use a combination of your organization name, purpose, and random characters. ReliefWeb reviews requests and replies by email.
Examples in this documentation use REPLACE-WITH-APP-NAME. Substitute your approved value before calling the API.
Publish also needs an API key and provider headers. See Access and credentials.
OpenAPI
An interactive OpenAPI schema is available for exploring endpoints and trying requests:
https://api.reliefweb.int/v2/swagger/api
Terms
Use of the API is governed by the ReliefWeb Terms & Conditions, including their limits on reusing content. Materials may be owned by their original sources, so respect their rights. Always send a valid appname. ReliefWeb may log calls and analyze usage.