Joshua Project API

Name: Joshua Project API
Brand: Joshua Project API
Availability: InStock

✓ Official Vendor SpecData EnrichmentCompany DataapiKey8 EndpointsREST

For Agents

Query Joshua Project's catalogue of people groups, countries, languages, regions, and continents, including a daily unreached people group feed and global totals, for missions research and demographic analysis.

Install Jentic One Beta

Connect the Joshua Project API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Joshua Project API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Joshua Project API.

List the world's continents with their associated people group totals

Query countries with filters by region, religion, or population range

Look up languages spoken globally and their associated people groups

GET STARTED

Start building with Joshua Project API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Joshua Project API for, with concrete tasks.

★ Daily prayer or focus app

Apps that surface a single people group each day for prayer or research can call the daily-unreached endpoint and render the response. GET /people_groups/daily_unreached.json returns a curated entry with population, language, religion, and progress data — enough to power a card UI without further calls. This replaces hand-curated daily content with a reliable feed maintained by Joshua Project.

Call GET /people_groups/daily_unreached.json each morning, render the response into a daily prayer card, and email or push it to subscribers

Missions research and country pages

Educational and missions agency websites need consistent country and people-group profiles. The API provides GET /countries.json with rich filters (region, population, religion) and GET /people_groups.json scoped to a country. A small static site generator can build a country index and per-people-group pages from these two endpoints in a single nightly job.

Call GET /countries.json filtered by ROG3='IN', then GET /people_groups.json for each, and render per-country pages in the static site

Cross-country language analysis

Researchers studying language families and migration patterns can use GET /people_groups_across_countries.json to find the same ethnolinguistic group across borders. Combined with GET /languages.json, this supports queries like 'where is the Tamil-speaking population concentrated outside India'. The aggregated view avoids stitching country-level data manually.

Call GET /people_groups_across_countries.json with peo3 code for Tamil to retrieve every country containing the group, then aggregate populations

Agent-driven research via Jentic

A research assistant agent can call Joshua Project through Jentic to answer demographic questions inline. The user asks 'how many unreached people groups are in Indonesia?', Jentic resolves to GET /people_groups.json with country=ID and an unreached filter, injects the api_key parameter, and returns the count. The api_key never enters the agent's prompt.

Use Jentic to search 'list Joshua Project people groups in Indonesia', load GET /people_groups.json, and execute with country=ID

Key Endpoints

8 endpoints — joshua project is a research initiative tracking ethnic people groups around the world, with a particular focus on those least reached by christian missions.

METHOD

PATH

DESCRIPTION

GET

/continents.json

List continents

GET

/countries.json

List countries

GET

/languages.json

List languages

GET

/people_groups.json

List people groups in countries

GET

/people_groups_across_countries.json

List people groups across countries

GET

/people_groups/daily_unreached.json

Daily unreached people group

GET

/regions.json

List regions

GET

/totals.json

Global totals

GET

/continents.json

List continents

GET

/countries.json

List countries

GET

/languages.json

List languages

GET

/people_groups.json

List people groups in countries

GET

/people_groups_across_countries.json

List people groups across countries

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The Joshua Project api_key is stored encrypted in the Jentic vault. Jentic appends it as a query parameter at call time, keeping it out of agent prompts, chat logs, and version-controlled code.

Intent-based discovery

Agents search Jentic with phrases like 'find unreached people groups' or 'list countries' and Jentic returns the matching Joshua Project operation with its input schema, replacing manual reading of the API docs.

Time to first call

Direct Joshua Project integration: a few hours to wire up key handling and response caching. Through Jentic: minutes — search and execute, with the key managed centrally.

FAQs

Specific to using Joshua Project API through Jentic.

What authentication does the Joshua Project API use?

The Joshua Project API uses an API key passed as the api_key query parameter on every request. Jentic stores the key encrypted in the vault and appends it at execution time, so the credential never enters the agent's prompt or chat transcript.

Can I get a single 'people group of the day' from this API?

Yes. GET /people_groups/daily_unreached.json returns the day's featured unreached people group with population, language, religion, and progress fields — enough to power a prayer card or daily research email without follow-up calls.

What are the rate limits for the Joshua Project API?

The spec does not publish numeric rate limits. The API is intended for non-commercial research and missions use; treat it as low-volume and cache responses where possible. Contact Joshua Project directly for higher-throughput agreements.

How do I query Joshua Project through Jentic?

Search Jentic for 'list Joshua Project people groups', load GET /people_groups.json, and execute with country or language filters. Jentic injects the api_key and returns the JSON list. Sign up at https://app.jentic.com/sign-up.

Is the Joshua Project data free to use?

API access is free for non-commercial missions and research use after registering for an API key on joshuaproject.net. Commercial republishing requires permission from Joshua Project.

How do I find a people group across multiple countries?

Use GET /people_groups_across_countries.json with the people group's identifier (peo3 code) — the response groups country-level entries for the same ethnolinguistic group, which is the right shape for diaspora analysis.