# HDX Documentation v2 ## Welcome - [Humanitarian Data Exchange Documentation](https://docs.humdata.org/readme.md): HDX is a centralized data platform for humanitarians. - [About the Humanitarian Data Exchange](https://docs.humdata.org/about/about-the-humanitarian-data-exchange.md): Learn HDX works with humanitarian data. - [Data Grids](https://docs.humdata.org/about/data-grids.md): A structured view of data availability across active humanitarian crises. - [HDX Metadata](https://docs.humdata.org/about/hdx-metadata.md): A reference for the dataset and resource fields available on HDX. - [HDX Signals](https://docs.humdata.org/about/hdx-signals.md) - [Datasets](https://docs.humdata.org/about/hdx-signals/datasets.md) - [Agricultural hotspots](https://docs.humdata.org/about/hdx-signals/datasets/agricultural-hotspots.md) - [Armed conflict](https://docs.humdata.org/about/hdx-signals/datasets/armed-conflict.md) - [Food insecurity](https://docs.humdata.org/about/hdx-signals/datasets/food-insecurity.md) - [INFORM Severity Index](https://docs.humdata.org/about/hdx-signals/datasets/inform-severity-index.md) - [Internal displacements](https://docs.humdata.org/about/hdx-signals/datasets/internal-displacements.md) - [Market monitoring](https://docs.humdata.org/about/hdx-signals/datasets/market-monitoring.md) - [Prompts](https://docs.humdata.org/about/hdx-signals/prompts.md) - [Data Licenses ](https://docs.humdata.org/about/data-licenses.md): The licenses under which data can be shared on HDX. - [HDX Terms of Service](https://docs.humdata.org/about/hdx-terms-of-service.md): How HDX is managed and what is expected of organizations and users. - [HAPI Terms of Service](https://docs.humdata.org/about/hdx-terms-of-service/hapi-terms-of-service.md): By using the HDX HAPI, you acknowledge that you have read, understood, and agreed to these terms of service. - [Glossary](https://docs.humdata.org/about/glossary.md): Definitions of key terms used across this documentation. ## Find - [Find data on HDX](https://docs.humdata.org/find/find-data-on-hdx.md) - [Understanding the HDX dataset page](https://docs.humdata.org/find/understanding-the-hdx-dataset-page.md) - [Accessing and using data](https://docs.humdata.org/find/accessing-and-using-data.md) - [Staying up-to-date with HDX](https://docs.humdata.org/find/staying-up-to-date-with-hdx.md) ## Publish - [Why publish on HDX?](https://docs.humdata.org/publish/publish-data/why-publish-on-hdx.md) - [Preparing and publishing data](https://docs.humdata.org/publish/publish-data/preparing-and-publishing-data.md) - [Organizations on HDX](https://docs.humdata.org/publish/publish-data/organizations-on-hdx.md) - [Maintaining data](https://docs.humdata.org/publish/publish-data/maintaining-data.md) - [HDX support](https://docs.humdata.org/publish/publish-data/hdx-support.md) ## Build - [Build with HDX](https://docs.humdata.org/build/overview/build-with-hdx.md): Build with HDX provides developers and data teams with the tools, APIs, and documentation needed to access, integrate, and extend humanitarian data. - [HDX core concepts](https://docs.humdata.org/build/overview/hdx-core-concepts.md): Essential HDX concepts referenced throughout products and integrations. - [HDX API overview](https://docs.humdata.org/build/hdx-apis/hdx-api-overview.md): The Humanitarian Data Exchange (HDX) API offers a set of endpoints that allows users to access, search, and interact with humanitarian data, as well as contribute through flexible and automated ways. - [File download endpoint](https://docs.humdata.org/build/hdx-apis/file-download-endpoint.md): A guide to accessing, downloading, and integrating HDX data through the File URL. - [Finding and downloading data](https://docs.humdata.org/build/hdx-apis/file-download-endpoint/finding-and-downloading-data.md): Many data resources can be accessed through the file download endpoint - [Tools](https://docs.humdata.org/build/hdx-apis/file-download-endpoint/tools.md): Learn how to use the file download in Power BI. - [Metadata endpoints](https://docs.humdata.org/build/hdx-apis/metadata-endpoints.md): A guide to accessing and cataloguing HDX data through the metadata endpoints. - [package\_search](https://docs.humdata.org/build/hdx-apis/metadata-endpoints/package_search.md): Learn how to query package\_search to catalogue data on HDX - [package\_show](https://docs.humdata.org/build/hdx-apis/metadata-endpoints/package_show.md): Learn how to query package\_show to learn more about a dataset on HDX - [Code examples and Python notebook](https://docs.humdata.org/build/hdx-apis/metadata-endpoints/code-examples-and-python-notebook.md): Python and Javascript examples and a ready-to-run Python notebook - [Troubleshooting and error handling](https://docs.humdata.org/build/hdx-apis/metadata-endpoints/troubleshooting-and-error-handling.md): Need help with the metadata endpoints? Look no further. - [Tabular Data Endpoints](https://docs.humdata.org/build/hdx-apis/tabular-data-endpoints.md): A guide to accessing, filtering, and integrating HDX data through the Tabular Data Endpoints. - [Available data and resource IDs](https://docs.humdata.org/build/hdx-apis/tabular-data-endpoints/available-data-and-resource-ids.md): How to find Tabular Data resources - [How to query the Tabular Data Endpoints](https://docs.humdata.org/build/hdx-apis/tabular-data-endpoints/how-to-query-the-tabular-data-endpoints.md): How to use the different Tabular Data endpoints - [Code examples](https://docs.humdata.org/build/hdx-apis/tabular-data-endpoints/code-examples.md): Python and Javascript examples - [Tools and notebook](https://docs.humdata.org/build/hdx-apis/tabular-data-endpoints/tools-and-notebook.md): Tabular Data endpoints tool integrations and Python notebook - [Troubleshooting and error handling](https://docs.humdata.org/build/hdx-apis/tabular-data-endpoints/troubleshooting-and-error-handling.md): Need help with the Tabular Data endpoints? Look no further. - [HAPI](https://docs.humdata.org/build/hdx-apis/hapi.md): Learn more about the HDX Humanitarian API. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on a page URL with the `ask` query parameter: ``` GET https://docs.humdata.org/readme.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.