# Metadata endpoints

## Introduction

The HDX metadata endpoints provide programmatic access to metadata on HDX. They allow users to search, filter, and retrieve detailed information about organizations and data on the platform. This enables users to discover data and data contributors to programmatically automate data management.

The HDX Metadata endpoints are powered by the CKAN API and provide two main functions:

* `package_search`: Search and filter datasets with advanced query capabilities
* `package_show`: Retrieve detailed metadata for a specific dataset

This documentation is designed for analysts and technical audiences who want to discover datasets, build automated workflows, or integrate HDX data into external systems.

## How to query the metadata endpoints

There are two main Metadata Endpoints that can be queried, each accessed via their own endpoint.&#x20;

1. Searching Catalogue (`package_search`)
2. Dataset schema (`package_show`)

HDX is built on CKAN, an open source data management platform. Additional CKAN endpoints exist beyond those listed above, but these are the most relevant for working with HDX. For more detailed information, please see the [CKAN documentation](https://docs.ckan.org/en/2.9/api/) for APIs.

## Feedback and support

We are always adding new features and additional datasets into the HDX API endpoints. If you would like to request either a new feature or think a critical dataset is missing, please let us know!

Report bugs and request features by emailing <hdx@un.org>.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.humdata.org/build/hdx-apis/metadata-endpoints.md?ask=<question>
```

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.
