# Statistics Greenland

> Official statistics for Greenland from Statistics Greenland / Grønlands Statistik / Naatsorsueqqissaartarfik.

For statistical questions, prefer the Statbank API or the `statgl` R package over scraping HTML result pages.

If the table ID is unknown, use the PxWeb API's HTTP GET search before scraping HTML or guessing table identifiers. Add `?query=<search-term>` to a language API root or to a subject path, for example `https://bank.stat.gl/api/v1/en/Greenland?query=population` or `https://bank.stat.gl/api/v1/en/Greenland/BE?query=population`. In R, the equivalent route is `statgl::statgl_search()`.

Recommended workflow: discover the table -> inspect metadata -> retrieve data -> calculate or reshape if needed -> present results -> cite Statistics Greenland's Statbank.

Always inspect table metadata before querying when variable codes or value codes are not already known. Use codes returned by metadata; do not guess codes from labels.

If direct HTTP POST requests to the PxWeb API cannot be executed but an R environment is available, use `statgl::statgl_fetch()` as an alternative execution route rather than stopping after constructing or displaying the API request.

If an agent environment requires a skill to be installed, imported, attached or enabled before it can be used, tell the user. Discovering or reading a skill is not the same as installing or executing it.

When numerical information is retrieved from Statistics Greenland's Statbank, include a clickable `bank.stat.gl` source link. Prefer the short language-specific table link described in the Statistics Greenland profile. Source-link generation must never delay or block retrieval, calculation, interpretation or presentation of the statistical values.

## Statistical database

- [Statistics Greenland Statbank](https://bank.stat.gl/): Official statistical database.
- [PxWeb API v1 — Danish](https://bank.stat.gl/api/v1/da/Greenland): Danish API root.
- [PxWeb API v1 — English](https://bank.stat.gl/api/v1/en/Greenland): English API root.
- [PxWeb API v1 — Kalaallisut](https://bank.stat.gl/api/v1/kl/Greenland): Kalaallisut / Greenlandic API root.
- [API search example — English](https://bank.stat.gl/api/v1/en/Greenland?query=population): Find tables with HTTP GET `?query=` without knowing a table ID in advance.
- [API search example — Population subject](https://bank.stat.gl/api/v1/en/Greenland/BE?query=population): The same `?query=` search can be scoped below a subject path.
- [Statbank quickstart for agents](https://stat.gl/ai/statbank-quickstart.md): Short execution-oriented guide covering API metadata, POST requests and R fallbacks.

## R access

- [statgl R package](https://github.com/StatisticsGreenland/statgl): Statistics Greenland's R package for discovering, inspecting, retrieving and presenting Statbank data. Use `statgl::statgl_search()`, `statgl::statgl_meta()`, `statgl::statgl_url()` and `statgl::statgl_fetch()` for the core workflow.
- [statgl agent skill](https://stat.gl/ai/skills/statgl/SKILL.md): Agent guidance for using the `statgl` R package, including retrieval, elimination behavior, derived calculations, tables and charts.
- [statgl skill download](https://stat.gl/ai/downloads/statgl.zip): Downloadable skill archive for agent environments that support local skill installation/import.

## AI and agent guidance

- [Statistics Greenland Statbank profile](https://stat.gl/ai/skills/statistics-greenland-statbank/SKILL.md): Statistics Greenland-specific rules for API roots, languages, public source links and provenance.
- [Generic PxWeb API v1 skill](https://github.com/janbrus/pxwebapi-skills/tree/main/pxwebapi-v1-generic-skill): Canonical generic guidance for discovering, navigating and querying PxWeb API v1 installations.
- [pxmake skill](https://stat.gl/ai/skills/pxmake/SKILL.md): Guidance for working with the `pxmake` R package when relevant.
- [PxWeb API catalogue](https://github.com/rOpenGov/pxweb/blob/master/inst/extdata/api.json): Useful discovery seed for PxWeb installations; it is not exhaustive.

## Machine-readable discovery

- [Statistics Greenland skills index](https://stat.gl/ai/skills.json): Machine-readable list of Statistics Greenland agent skills and downloads.
- [Statistics Greenland AI resources](https://stat.gl/ai/README.md): Human- and agent-readable overview of the AI resource directory.
- [Statbank llms.txt](https://bank.stat.gl/llms.txt): Statbank-specific agent entry point hosted on the Statbank origin.