Search ReliefWeb Reports
reliefweb_search_reportsRead-onlyIdempotent
Search humanitarian reports on ReliefWeb with filtering by country, disaster, format, theme, language, source, and date. Returns paginated summaries — use reliefweb_get_report to fetch full body text. Report body is excluded from results (10–100KB each); call get_report when document content is needed. Every report is reachable by default — reports have no archived class, so include_archived has no effect here. Note: each call counts against the 1,000 calls/day quota.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "reliefweb_search_reports"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort order. Use date.original:desc for newest first (default), date.original:asc for oldest first, score:desc for relevance. | |
| text | No | Full-text search query. Matches against title, body, and key metadata fields. Use plain natural language or keywords. | |
| limit | No | Number of results to return (1–1000, default 10). Larger integers are clamped to 1000 with a notice when clamping is enabled; otherwise they are rejected. Use a smaller value for targeted lookups; larger for bulk research. Each call counts against the 1,000-calls/day quota. | |
| theme | No | Sector or cross-cutting theme (e.g., Health, Food and Nutrition, Shelter and Non-Food Items, Protection). Open-ended — matches theme.name exactly as ReliefWeb spells it. | |
| filter | No | Raw ReliefWeb filter object for compound conditions not covered by named params. Example: {"operator": "AND", "conditions": [{"field": "format.name", "value": "Map"}, {"field": "language.code", "value": "fr"}]}. | |
| format | No | Content format filter. One of: News and Press Release, Situation Report, Map, Infographic, Analysis, Other, Assessment, Manual and Guideline, Appeal, UN Document, Evaluation and Lessons Learned. Case, spacing, and punctuation are ignored; any other value is rejected with the valid list. | |
| offset | No | Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through large result sets. | |
| source | No | Organization short name (e.g., UNHCR, OCHA, WFP). Filters on source.shortname. | |
| country | No | ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to content tagged with this country. | |
| date_to | No | Latest publication date. Pair with date_from for a date range. A bare calendar date resolves to end of that day in UTC, so the range covers it in full; a datetime carrying any offset is resolved to UTC. | |
| language | No | ISO 639-1 language code (e.g., en, fr, es, ar). Filters on language.code. | |
| date_from | No | Earliest publication date. Filters on date.original (source publication date). A bare calendar date such as 2024-01-15 is accepted and resolves to start of that day in UTC; a datetime carrying any offset is resolved to UTC. | |
| disaster_id | No | ReliefWeb numeric disaster ID. Filters to reports linked to a specific disaster. Get the ID from reliefweb_search_disasters. | |
| include_archived | No | No effect on reports. Reports have no archived class — every report is already in scope, whatever this is set to. Kept so existing calls that pass it keep working; it is meaningful on reliefweb_search_jobs, reliefweb_search_training, and reliefweb_search_disasters. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when the call failed. Absent on success. | |
| items | No | Matching reports (summaries only — use reliefweb_get_report for full body). | |
| notice | No | Discloses requested and applied limits when clamped, an ignored empty raw filter, and empty-page guidance with the match count and last reachable offset or suggestions to broaden the search. | |
| totalCount | No | Total reports matching the query before pagination. | |
| appliedFilters | No | The resolved filter set the query actually ran with, after normalization and defaults. Echoes back so the agent can confirm how its inputs were interpreted. |