Skip to main content
The Analytics endpoints give you quantitative insight into the state of your localization work. Use them to track translation coverage, identify languages that need attention, monitor team productivity, and report progress to stakeholders. Analytics are computed in real time against the live translation data, so the numbers always reflect the current state of your project.

Endpoints

GET    /api/projects/:projectId/analytics/progress              Translation progress by language
GET    /api/projects/:projectId/analytics/progress-over-time    Progress trend over time
GET    /api/projects/:projectId/analytics/contributors          Contributor activity stats
GET    /api/organizations/:orgId/analytics/overview             Organization-wide overview

Translation Progress by Language

Returns translation coverage and completion metrics for a project, broken down by language:
curl "https://api.nt3.io/api/projects/proj_6abc123def456/analytics/progress?languages=fr,de,es" \
  -H "Cookie: session=..."
Query parameters:
ParameterTypeDescription
languagesstringComma-separated list of language codes to include (e.g. fr,de).
Response:
{
  "totalKeys": 342,
  "languages": [
    {
      "language": "fr",
      "totalKeys": 342,
      "translated": 318,
      "reviewed": 295,
      "approved": 290,
      "completionPercent": 93
    },
    {
      "language": "de",
      "totalKeys": 342,
      "translated": 201,
      "reviewed": 185,
      "approved": 180,
      "completionPercent": 59
    }
  ]
}
completionPercent is calculated as translated / totalKeys × 100. Keys with status translated, reviewed, or approved all count as translated.

Progress Over Time

Returns a daily time series of translation activity for the last N days:
curl "https://api.nt3.io/api/projects/proj_6abc123def456/analytics/progress-over-time?days=30" \
  -H "Cookie: session=..."
Query parameters:
ParameterTypeDefaultDescription
daysnumber30Number of days of history to return.
Response:
[
  { "date": "2025-03-01", "translations": 12, "reviews": 5 },
  { "date": "2025-03-02", "translations": 24, "reviews": 8 }
]

Contributor Stats

Returns per-contributor activity statistics for a project:
curl "https://api.nt3.io/api/projects/proj_6abc123def456/analytics/contributors" \
  -H "Cookie: session=..."
Response:
[
  {
    "userId": "user_abc",
    "userName": "Alice Martin",
    "translations": 120,
    "reviews": 45,
    "approvals": 30
  },
  {
    "userId": "user_def",
    "userName": "Bob Smith",
    "translations": 80,
    "reviews": 20,
    "approvals": 15
  }
]

Organization Overview

Returns a high-level overview of localization progress across all projects in an organization:
curl "https://api.nt3.io/api/organizations/org_789xyz/analytics/overview" \
  -H "Cookie: session=..."
Response:
{
  "totalProjects": 5,
  "totalKeys": 1842,
  "totalTranslations": 9210,
  "languagesWithProgress": [
    { "language": "fr", "completionPercent": 87 },
    { "language": "de", "completionPercent": 64 }
  ]
}