--- type: "firecrawl-provider" description: "IHME Global Burden of Disease Results tool metadata: release versions and the full cause, location, age, sex, measure, metric and risk-factor (REI) hierarchies for GBD 2021 and GBD 2023." use_when: "Which GBD causes, locations, ages, sexes, measures, metrics and risk factors exist in a round, how they nest, and which results-tool version they belong to." categories: "Health" capabilities: 4 credits_per_call: 1 --- # IHME GBD Results on Firecrawl Alexandria IHME Global Burden of Disease Results tool metadata: release versions and the full cause, location, age, sex, measure, metric and risk-factor (REI) hierarchies for GBD 2021 and GBD 2023. - Categories: Health - Category index: [Health category](https://firecrawl.dev/alexandria/agents/categories/health) - Provider key: `ihme-gbd-results` - Access: Firecrawl credits - Cost: 1 credit per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/ihme-gbd-results) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/ihme-gbd-results/openapi.json) ## Capabilities - [Release versions](https://firecrawl.dev/alexandria/agents/providers/ihme-gbd-results/gbd/versions): List the GBD Results tool release versions (version id, GBD round, release stamp, model description, exposed measure ids) for one or both supported rounds. Use it to pin gbd_round/version_id and read the tool's stated release date. - [Hierarchy page](https://firecrawl.dev/alexandria/agents/providers/ihme-gbd-results/gbd/metadata): One page of hierarchy_node records for an entity type (cause, location, age, sex, measure, metric, rei) in a GBD round: id, name, parent_id, level, tree placement and the raw source entry. Tree types come in depth-first hierarchy order; page with cursor until next_cursor is null. - [Entity lookup](https://firecrawl.dev/alexandria/agents/providers/ihme-gbd-results/gbd/lookup): Resolve one entity (cause, location, age, sex, measure, metric or rei) by GBD id in a GBD round: its hierarchy_node record plus ancestors (root first) and direct children. - [Hierarchy children](https://firecrawl.dev/alexandria/agents/providers/ihme-gbd-results/gbd/children): Traverse one level down a hierarchy: the direct children of a cause, location or rei node (e.g. GBD region Western Europe to its 24 countries), plus the parent node and its ancestors. ## 1. Choose this provider when Which GBD causes, locations, ages, sexes, measures, metrics and risk factors exist in a round, how they nest, and which results-tool version they belong to. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "ihme-gbd-results", "capability": "gbd/versions", "options": { "gbd_round": 2021 } } ``` ## 3. Add provider options Use only the options needed for the task: - `gbd_round` (number): Restrict to one round (2021 or 2023); omit for both. Example: `2021` - `proxy` (object): Optional runner proxy override {kind: datacenter|residential|mobile, country?, sticky?}. Staging leases datacenter only. Example: `{}` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "ihme-gbd-results", capability: "gbd/versions", options: { gbd_round: 2021, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "ihme-gbd-results", "capability": "gbd/versions", "options": { "gbd_round": 2021 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "ihme-gbd-results", "capability": "gbd/versions", "options": { "gbd_round": 2021 } } }' ``` ### CLI ```sh firecrawl scrape 'ihme-gbd-results/gbd/versions' \ --options '{"gbd_round":2021}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "ihme-gbd-results", "capability": "gbd/versions", "options": { "gbd_round": 2021 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "ihme-gbd-results", "capability": "gbd/versions", "options": { "gbd_round": 2021 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "records": [ { "gbd_round": 0, "version_id": 0, "description": "", "release_stamp_raw": "", "source_updated_at": "", "status": 0, "measure_ids": [], "population_ids": [], "tool_url": "", "source_url": "", "observed_at_ms": 0 } ] } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Release versions - Capability: `gbd/versions` - Description: List the GBD Results tool release versions (version id, GBD round, release stamp, model description, exposed measure ids) for one or both supported rounds. Use it to pin gbd_round/version_id and read the tool's stated release date. - Instructions: List the GBD Results tool release versions (version id, GBD round, release stamp, model description, exposed measure ids) for one or both supported rounds. Use it to pin gbd_round/version_id and read the tool's stated release date. - Cost: 1 credit per call - Capability file: [Release versions](https://firecrawl.dev/alexandria/agents/providers/ihme-gbd-results/gbd/versions) Accepted options: - `gbd_round` (number): Restrict to one round (2021 or 2023); omit for both. Example: `2021` - `proxy` (object): Optional runner proxy override {kind: datacenter|residential|mobile, country?, sticky?}. Staging leases datacenter only. Example: `{}` Response schema example: ```json { "records": [ { "gbd_round": 0, "version_id": 0, "description": "", "release_stamp_raw": "", "source_updated_at": "", "status": 0, "measure_ids": [], "population_ids": [], "tool_url": "", "source_url": "", "observed_at_ms": 0 } ] } ``` ### Hierarchy page - Capability: `gbd/metadata` - Description: One page of hierarchy_node records for an entity type (cause, location, age, sex, measure, metric, rei) in a GBD round: id, name, parent_id, level, tree placement and the raw source entry. Tree types come in depth-first hierarchy order; page with cursor until next_cursor is null. - Instructions: One page of hierarchy_node records for an entity type (cause, location, age, sex, measure, metric, rei) in a GBD round: id, name, parent_id, level, tree placement and the raw source entry. Tree types come in depth-first hierarchy order; page with cursor until next_cursor is null. - Cost: 1 credit per call - Capability file: [Hierarchy page](https://firecrawl.dev/alexandria/agents/providers/ihme-gbd-results/gbd/metadata) Accepted options: - `type` (string, required): Entity type to list. Example: `cause` - `gbd_round` (number, required): GBD round served by the Results tool: 2021 (gbd2021.healthdata.org) or 2023 (vizhub.healthdata.org, current release). Pinned on every record. Example: `2021` - `page_size` (number): Records per page. Example: `200` - `cursor` (string): next_cursor from the previous page of the same type and gbd_round. Example: `` - `proxy` (object): Optional runner proxy override {kind: datacenter|residential|mobile, country?, sticky?}. Staging leases datacenter only. Example: `{}` Response schema example: ```json { "records": [ { "type": "", "id": 0, "name": "", "parent_id": 0, "level": 0, "iso3": "", "gbd_round": 0, "version_id": 0, "source_updated_at": "", "tree": "", "rei_type": "", "short_name": "", "most_detailed": false, "sort_order": 0, "children_count": 0, "child_ids": [], "source": {}, "source_url": "", "observed_at_ms": 0 } ] } ``` ### Entity lookup - Capability: `gbd/lookup` - Description: Resolve one entity (cause, location, age, sex, measure, metric or rei) by GBD id in a GBD round: its hierarchy_node record plus ancestors (root first) and direct children. - Instructions: Resolve one entity (cause, location, age, sex, measure, metric or rei) by GBD id in a GBD round: its hierarchy_node record plus ancestors (root first) and direct children. - Cost: 1 credit per call - Capability file: [Entity lookup](https://firecrawl.dev/alexandria/agents/providers/ihme-gbd-results/gbd/lookup) Accepted options: - `type` (string, required): Entity type. Example: `cause` - `id` (number, required): GBD entity id, e.g. cause 493 (ischemic heart disease), location 102 (USA), age 27 (age-standardized), rei 99 (smoking). Example: `10` - `gbd_round` (number, required): GBD round served by the Results tool: 2021 (gbd2021.healthdata.org) or 2023 (vizhub.healthdata.org, current release). Pinned on every record. Example: `2021` - `proxy` (object): Optional runner proxy override {kind: datacenter|residential|mobile, country?, sticky?}. Staging leases datacenter only. Example: `{}` Response schema example: ```json { "records": [ { "type": "", "id": 0, "name": "", "parent_id": 0, "level": 0, "iso3": "", "gbd_round": 0, "version_id": 0, "source_updated_at": "", "tree": "", "rei_type": "", "short_name": "", "most_detailed": false, "sort_order": 0, "children_count": 0, "child_ids": [], "source": {}, "source_url": "", "observed_at_ms": 0 } ] } ``` ### Hierarchy children - Capability: `gbd/children` - Description: Traverse one level down a hierarchy: the direct children of a cause, location or rei node (e.g. GBD region Western Europe to its 24 countries), plus the parent node and its ancestors. - Instructions: Traverse one level down a hierarchy: the direct children of a cause, location or rei node (e.g. GBD region Western Europe to its 24 countries), plus the parent node and its ancestors. - Cost: 1 credit per call - Capability file: [Hierarchy children](https://firecrawl.dev/alexandria/agents/providers/ihme-gbd-results/gbd/children) Accepted options: - `type` (string, required): Hierarchical entity type. Example: `cause` - `id` (number, required): Parent node id, e.g. location 73 (Western Europe), cause 294 (All causes), rei 169 (All risk factors). Example: `10` - `gbd_round` (number, required): GBD round served by the Results tool: 2021 (gbd2021.healthdata.org) or 2023 (vizhub.healthdata.org, current release). Pinned on every record. Example: `2021` - `proxy` (object): Optional runner proxy override {kind: datacenter|residential|mobile, country?, sticky?}. Staging leases datacenter only. Example: `{}` Response schema example: ```json { "records": [ { "type": "", "id": 0, "name": "", "parent_id": 0, "level": 0, "iso3": "", "gbd_round": 0, "version_id": 0, "source_updated_at": "", "tree": "", "rei_type": "", "short_name": "", "most_detailed": false, "sort_order": 0, "children_count": 0, "child_ids": [], "source": {}, "source_url": "", "observed_at_ms": 0 } ] } ```