M
API Matrix

Joshua Project API

Open Data / API Key Intermediate HTTPS
Varies by plan (check documentation)
72 Score
Grade B
Visit Official Site Compare Alternatives

Overview

The Joshua Project API provides data on people groups around the world, focusing on those with the fewest followers of Christ for missionary research purposes. An API key is required and can be requested for free. It is useful for building religious research tools, demographic apps, or mission strategy dashboards.

💡

Beginner Tip

Request a free API key from api.joshuaproject.net and include it as the api_key query parameter in every request. Start with the /people_groups endpoint to explore available filters.

Available Data

Joshua Project data via REST API
JSON-formatted response data
Requires API key authentication

Example Response

JSON Response 
{
  "status": "success",
  "data": {
    "result": "Data from Joshua Project",
    "description": "People groups of the world with the fewest followers of Christ",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

PeopleName Name of the people group.
Ctry Country name where this people group is located.
Population Estimated population size of the people group.
PrimaryLanguageName The main language spoken by the people group.
PercentChristianity Estimated percentage of the group that identify as Christian.

Implementation Example 

const url = "https://api.joshuaproject.net/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 Unauthorized API key is missing or invalid.
✓ Include your API key as a query parameter: ?api_key=YOUR_API_KEY in the request URL.
No results returned Filter values such as country code or language may not match any records.
✓ Check the API documentation for valid filter values; country codes use ISO 3166-1 alpha-2 format.
Unexpected field names The API uses custom field names that may not be obvious.
✓ Reference the field glossary in the Joshua Project API documentation to understand each returned property.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 5/20
🔒 Security 15/15
🛠 Developer XP 12/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS UNKNOWN
Category Open Data
Difficulty Intermediate
Verified: 2026-04-04

Similar APIs

View All →

Black History Facts

⭐ Beginner's Pick
77

The Black History Facts API gives you access to one of the largest databases of Black history facts on the web.

API Key Intermediate HTTPS

CARTO

72

CARTO is a geospatial platform API that provides location intelligence and data analysis tools for mapping and prediction.

API Key Intermediate HTTPS

Enigma Public

77

Enigma Public is a platform that aggregates a broad collection of public datasets from government and other sources into a single searchable API.

API Key Intermediate HTTPS

Kaggle

0

Kaggle provides programmatic access to create and interact with datasets, notebooks, and connect with kaggle via REST API.

API Key Intermediate HTTPS

LinkPreview

⭐ Beginner's Pick
77

LinkPreview is an API that fetches a summary of any URL including its title, description, and preview image in JSON format.

API Key Intermediate HTTPS