# Matomo User Country API

**Canonical:** https://apis.io/apis/matomo/matomo-usercountry-api/  
**Provider:** Matomo — https://apis.io/providers/matomo/  
**Base URL:** https://{matomo_host}/index.php  
**Documentation:** https://developer.matomo.org/api-reference/reporting-api

Matomo User Country API is one of 61 APIs that [Matomo](https://apis.io/providers/matomo/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include UserCountry. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

The UserCountry API lets you access reports about your visitors' Countries and Continents.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| GET | `/index.php?module=API&method=UserCountry.getCountry` | — |
| GET | `/index.php?module=API&method=UserCountry.getContinent` | — |
| GET | `/index.php?module=API&method=UserCountry.getRegion` | — |
| GET | `/index.php?module=API&method=UserCountry.getCity` | — |
| GET | `/index.php?module=API&method=UserCountry.getCountryCodeMapping` | — |
| GET | `/index.php?module=API&method=UserCountry.getLocationFromIP` | — |
| GET | `/index.php?module=API&method=UserCountry.setLocationProvider` | — |
| GET | `/index.php?module=API&method=UserCountry.getNumberOfDistinctCountries` | — |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/matomo/refs/heads/main/openapi/matomo-usercountry-api-openapi.yml
- **Documentation** — https://developer.matomo.org/api-reference/reporting-api
- **Documentation** — https://developer.matomo.org/api-reference/reporting-api#Live
- **Documentation** — https://developer.matomo.org/api-reference/reporting-api#Goals
- **Documentation** — https://developer.matomo.org/api-reference/reporting-api-segmentation

## Other Matomo APIs (12)

- [Matomo Reporting API (index.php entrypoint)](https://apis.io/apis/matomo/matomo-index-php-api/)
- [Matomo Tracking API (matomo.php entrypoint)](https://apis.io/apis/matomo/matomo-matomo-php-api/)
- [Matomo Ab Testing API](https://apis.io/apis/matomo/matomo-abtesting-api/)
- [Matomo Actions API](https://apis.io/apis/matomo/matomo-actions-api/)
- [Matomo Activity Log API](https://apis.io/apis/matomo/matomo-activitylog-api/)
- [Matomo Advertising Conversion Export API](https://apis.io/apis/matomo/matomo-advertisingconversionexport-api/)
- [Matomo Annotations API](https://apis.io/apis/matomo/matomo-annotations-api/)
- [Matomo API](https://apis.io/apis/matomo/matomo-api-api/)
- [Matomo API Reference API](https://apis.io/apis/matomo/matomo-apireference-api/)
- [Matomo Bandwidth API](https://apis.io/apis/matomo/matomo-bandwidth-api/)
- [Matomo Cohorts API](https://apis.io/apis/matomo/matomo-cohorts-api/)
- [Matomo Contents API](https://apis.io/apis/matomo/matomo-contents-api/)

## Tags

UserCountry

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/matomo/matomo-usercountry-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/matomo/.