Joshua Project

{
  "service_type": "platform",
  "base_url": "https://api.joshuaproject.net",
  "auth_method": "api_key",
  "auth_config": {
    "api_key": "required",
    "header_name": "X-API-Key",
    "query_param": "api_key"
  },
  "endpoints": [
    {
      "path": "/v1/people-groups",
      "method": "GET",
      "description": "List people groups with filters and pagination"
    },
    {
      "path": "/v1/people-groups/{id}",
      "method": "GET",
      "description": "Get details for a specific people group"
    },
    {
      "path": "/v1/regions",
      "method": "GET",
      "description": "List world regions"
    },
    {
      "path": "/v1/countries",
      "method": "GET",
      "description": "List countries"
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free_tier": "Limited access with API key registration",
      "paid_tiers": "Higher usage limits and data access available upon request"
    }
  },
  "rate_limits": {},
  "capabilities": [
    "Access to detailed ethnographic data on people groups",
    "Filtering by region, country, religion, language, progress indicators",
    "Data on least-reached people groups",
    "Support for missiological research and prayer initiatives",
    "JSON responses for integration",
    "API key management for registered users"
  ],
  "raw_analysis": "Joshua Project is a Christian mission organization focused on providing information about people groups worldwide, with a specific emphasis on those with the fewest followers of Christ. The API at https://api.joshuaproject.net is part of their data distribution platform, offering programmatic access to their extensive datasets. The service is primarily used by missiologists, researchers, non-profit organizations, and churches to identify and pray for unreached people groups. The platform is mature, having been in operation for decades, and the API provides reliable data with JSON responses. Authentication requires an API key, typically obtained by registering on their website. The pricing model is freemium with a free tier for general access and potential paid subscriptions for higher-volume or premium data. Rate limits are not publicly documented, so they are likely moderate. The API offers common endpoints for people groups, regions, and countries, enabling filters based on various attributes. Integrations are primarily through direct HTTP calls, with no official SDKs, but the RESTful nature makes it easy to integrate with any system. Overall, it is a valuable resource for anyone involved in global missions research."
}

1/3 tests passed

```json
{
  "overall": 62,
  "dimensions": {
    "token_efficiency": 6.5,
    "first_try_success": 6.0,
    "response_parseability": 8.0,
    "error_clarity": 5.5,
    "doc_quality": 5.0,
    "auth_simplicity": 7.0,
    "latency": 8.5,
    "consistency": 5.5
  },
  "pricing_normalized": {
    "free_tier": "Yes — limited access with API key registration",
    "paid_tiers": "Higher usage limits and data access available upon request",
    "model": "freemium"
  },
  "issues": [
    "No robots.txt or llms.txt file found (404) — limits discoverability and machine-readable guidance",
    "No security headers detected on website response",
    "Pricing details for paid tiers are vague ('available upon request') — not self-serve",
    "No explicit documentation of rate limits, data freshness, or API stability that I could verify from the checks",
    "Freemium model requires API key registration even for free tier, adding a small onboarding step"
  ],
  "recommendations": [
    "Add llms.txt to expose structured API documentation and capabilities for AI agents",
    "Publish concrete pricing tiers and rate limits publicly on the website",
    "Include a getting-started guide with example requests and JSON response samples",
    "Add security headers (e.g., CSP, X-Content-Type-Options) for improved trust signals",
    "Provide a public status page or uptime history to build consistency confidence"
  ]
}
```