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
Anyone may use the ReliefWeb API. Reports, jobs, and training may include material owned by the original source. Respect those rights when reusing content.
ReliefWeb may log calls and analyze usage. Always send a valid appname so usage can be attributed.