# Worlddata — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Explore global statistics and compare countries across population, economy, demographics, quality of life, education, and health metrics. Search worldwide data on everything from life expectancy and languages to religions and regional breakdowns to gain comprehensive insights into how nations rank against each other.

**Category:** Government & Public Data | **Website:** [worlddata.info/](https://worlddata.info/) | **Docs:** [parse.bot/marketplace/199791d0-dc7f-490a-b324-671849562c15/worlddata-info-api](https://parse.bot/marketplace/199791d0-dc7f-490a-b324-671849562c15/worlddata-info-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-worlddata-info-api-199791d0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### compare_countries

Side-by-side comparison of two countries across population, economy, infrastructure, healthcare, education, climate, and more. Sections vary by country pair.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country1` | string | Yes | ISO 3166-1 alpha-3 code for the first country (e.g. 'USA', 'DEU', 'FRA', 'JPN'). |
| `country2` | string | Yes | ISO 3166-1 alpha-3 code for the second country (e.g. 'DEU', 'GBR', 'CHN', 'IND'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worlddata-info-api-199791d0/compare_countries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country1":"<string>","country2":"<string>"}'
```

### get_average_body_height

Countries ranked by average body height, including weight and BMI.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worlddata-info-api-199791d0/get_average_body_height \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_countries_by_region

Countries and statistics grouped by sub-region for a continent, including most spoken languages and country listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `region` | string | Yes | Continent/region name: 'europe', 'asia', 'africa', 'america', 'oceania'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worlddata-info-api-199791d0/get_countries_by_region \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region":"<string>"}'
```

### get_country_codes

International country codes for all countries: ISO 3166-1 alpha-2, alpha-3, numeric, IOC, FIPS 10, license plate, and internet domain codes.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worlddata-info-api-199791d0/get_country_codes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_country_economy

Economic statistics for a country including top companies, imports/exports, and budget data, organized by section.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_path` | string | Yes | Country path as 'continent/country' (e.g. 'europe/germany', 'america/usa', 'asia/japan'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worlddata-info-api-199791d0/get_country_economy \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_path":"<string>"}'
```

### get_country_overview

Detailed overview of a single country covering languages, religions, economy, transport, land use, and political indicators. Data is organized into named sections.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_path` | string | Yes | Country path as 'continent/country' (e.g. 'europe/germany', 'asia/japan', 'america/usa', 'africa/nigeria'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worlddata-info-api-199791d0/get_country_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_path":"<string>"}'
```

### get_country_population_history

Year-by-year historical population growth for a country, including birth/death rates compared to world averages. May include sub-national regional data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_path` | string | Yes | Country path as 'continent/country' (e.g. 'europe/germany', 'asia/japan', 'america/usa'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worlddata-info-api-199791d0/get_country_population_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_path":"<string>"}'
```

### get_education_by_country

Countries ranked by educational attainment from elementary through doctoral levels, with an overall ranking score.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worlddata-info-api-199791d0/get_education_by_country \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_iq_by_country

Countries ranked by average IQ score, with average income, education expenditure per inhabitant, and average daily maximum temperature.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worlddata-info-api-199791d0/get_iq_by_country \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_languages_worldwide

Global ranking of languages by number of native speakers, including how many countries each is spoken in and used as an official language.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worlddata-info-api-199791d0/get_languages_worldwide \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_largest_countries

Countries ranked by total population, including area and population density per km².

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worlddata-info-api-199791d0/get_largest_countries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_life_expectancy_worldwide

Countries ranked by life expectancy, including male and female life expectancy, birth rate, and death rate.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worlddata-info-api-199791d0/get_life_expectancy_worldwide \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_population_density_worldwide

Countries ranked by population density (inhabitants per km²). Each record includes country name, area, population, and density.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worlddata-info-api-199791d0/get_population_density_worldwide \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_population_growth_worldwide

Ranked list of countries by average annual population growth rate for a given period. Each record includes country name, average yearly growth percentage, and total growth over the period. Defaults to 2015-2024 when no period is specified.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `period` | string | No | Time period in 'YYYY-YYYY' format. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worlddata-info-api-199791d0/get_population_growth_worldwide \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"period":"<string>"}'
```

### get_quality_of_life

Countries ranked by composite quality of life index with sub-scores for stability, rights, health, safety, climate, costs, and popularity.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worlddata-info-api-199791d0/get_quality_of_life \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_refugees_data

Refugee statistics: top countries of origin and top destination countries with asylum application counts per year.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worlddata-info-api-199791d0/get_refugees_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_religions_worldwide

Global distribution of religions ranked by worldwide percentage of followers, including regional distribution details.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worlddata-info-api-199791d0/get_religions_worldwide \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_site

Full-text search across all worlddata.info content. Returns matching page titles, URLs, and description snippets.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword or phrase (e.g. 'population', 'climate France', 'GDP'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worlddata-info-api-199791d0/search_site \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```