Using the API

Requires the requests library (pip install requests).

Fetch a single people group

import requests

response = requests.get(
    "https://peoplegroups.org/wp-json/pg/v1/people-groups/PG012345"
)
response.raise_for_status()

group = response.json()
print(group["NmDisp"])   # Nateni
print(group["Ctry"])     # Benin
print(group["LPIname"])  # Pioneer Unreached People Group

Page through all people groups

import requests

BASE_URL = "https://peoplegroups.org/wp-json/pg/v1/people-groups"
page = 1
all_groups = []

while True:
    response = requests.get(BASE_URL, params={"page": page, "per_page": 250})
    response.raise_for_status()

    batch = response.json()
    all_groups.extend(batch)

    total_pages = int(response.headers.get("X-WP-TotalPages", 1))
    if page >= total_pages:
        break
    page += 1

print(f"Fetched {len(all_groups)} people groups")

Uses the native fetch API (Node 18+). No dependencies required.

Fetch a single people group

const response = await fetch(
  "https://peoplegroups.org/wp-json/pg/v1/people-groups/PG012345"
);

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.message);
}

const group = await response.json();
console.log(group.NmDisp);   // Nateni
console.log(group.Ctry);     // Benin
console.log(group.LPIname);  // Pioneer Unreached People Group

Page through all people groups

const BASE_URL = "https://peoplegroups.org/wp-json/pg/v1/people-groups";
let page = 1;
let totalPages = 1;
const allGroups = [];

do {
  const response = await fetch(`${BASE_URL}?page=${page}&per_page=250`);
  const batch = await response.json();
  allGroups.push(...batch);

  totalPages = parseInt(response.headers.get("X-WP-TotalPages") ?? "1", 10);
  page++;
} while (page <= totalPages);

console.log(`Fetched ${allGroups.length} people groups`);

Fetch a single people group (WordPress context)

$response = wp_remote_get(
    'https://peoplegroups.org/wp-json/pg/v1/people-groups/PG012345'
);

if ( is_wp_error( $response ) ) {
    error_log( $response->get_error_message() );
    return;
}

$group = json_decode( wp_remote_retrieve_body( $response ), true );
echo esc_html( $group['NmDisp'] );  // Nateni
echo esc_html( $group['Ctry'] );    // Benin

Fetch a single people group (plain PHP)

$pgid = 'PG012345';
$url  = 'https://peoplegroups.org/wp-json/pg/v1/people-groups/' . urlencode( $pgid );
$json = file_get_contents( $url );

if ( $json === false ) {
    throw new RuntimeException( 'Failed to fetch people group data' );
}

$group = json_decode( $json, true );
echo htmlspecialchars( $group['NmDisp'] );  // Nateni

Page through all people groups

$base_url    = 'https://peoplegroups.org/wp-json/pg/v1/people-groups';
$page        = 1;
$total_pages = 1;
$all_groups  = [];

do {
    $url      = $base_url . '?' . http_build_query( [ 'page' => $page, 'per_page' => 250 ] );
    $response = wp_remote_get( $url );

    if ( is_wp_error( $response ) ) {
        break;
    }

    $batch       = json_decode( wp_remote_retrieve_body( $response ), true );
    $all_groups  = array_merge( $all_groups, $batch );
    $total_pages = (int) wp_remote_retrieve_header( $response, 'x-wp-totalpages' );
    $page++;
} while ( $page <= $total_pages );

echo count( $all_groups ) . ' people groups fetched';

Requires reqwest and serde_json. Add to Cargo.toml:

[dependencies]
reqwest = { version = "0.12", features = ["json"] }
serde_json = "1"
tokio = { version = "1", features = ["full"] }

Fetch a single people group

use reqwest;
use serde_json::Value;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let url = "https://peoplegroups.org/wp-json/pg/v1/people-groups/PG012345";
    let group: Value = reqwest::get(url).await?.json().await?;

    println!("{}", group["NmDisp"]);   // "Nateni"
    println!("{}", group["Ctry"]);     // "Benin"
    println!("{}", group["LPIname"]); // "Pioneer Unreached People Group"

    Ok(())
}

Page through all people groups

use reqwest::Client;
use serde_json::Value;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let base_url = "https://peoplegroups.org/wp-json/pg/v1/people-groups";
    let mut page = 1u32;
    let mut total_pages = 1u32;
    let mut all_groups: Vec<Value> = Vec::new();

    loop {
        let response = client
            .get(base_url)
            .query(&[("page", page.to_string()), ("per_page", "250".to_string())])
            .send()
            .await?;

        total_pages = response
            .headers()
            .get("X-WP-TotalPages")
            .and_then(|v| v.to_str().ok())
            .and_then(|v| v.parse().ok())
            .unwrap_or(1);

        let batch: Vec<Value> = response.json().await?;
        all_groups.extend(batch);

        if page >= total_pages {
            break;
        }
        page += 1;
    }

    println!("Fetched {} people groups", all_groups.len());
    Ok(())
}