5-Minute Developer Quickstart
GlobalizationOS is localization infrastructure for applications. This quickstart uses the Developer API V1 — not the website widget path.
- Create a GlobalizationOS account
- Create a developer project (Custom API integration)
- Generate and copy your API key (gos_live_…)
- Store the key: export GLOBALIZATIONOS_API_KEY=gos_live_…
- Send your first localization request (curl or TypeScript below)
- Read the returned localized segments
- Render output in your app — see the Next.js example
- Add target languages and integrate in production
Environment
Shell
export GLOBALIZATIONOS_API_KEY=gos_live_your_secret
export GLOBALIZATIONOS_PROJECT_ID=your-project-uuidFirst localization call (curl)
curl
curl -sS -X POST 'https://api.globalizationos.com/api/v1/api/v1/developer/translations' \
-H 'Authorization: Bearer $GLOBALIZATIONOS_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"projectId": "YOUR_PROJECT_ID",
"sourceLocale": "de",
"targetLocale": "en",
"text": "Guten Morgen"
}'First localization call (TypeScript)
TypeScript
import { GlobalizationOSClient } from '@globalizationos/integration-core';
const client = new GlobalizationOSClient({
apiKey: process.env.GLOBALIZATIONOS_API_KEY!,
baseUrl: 'https://api.globalizationos.com/api/v1/api/v1',
});
const result = await client.translate({
projectId: process.env.GLOBALIZATIONOS_PROJECT_ID!,
sourceLocale: 'de',
targetLocale: 'en',
text: 'Guten Morgen',
});
console.log(result.segments);Expected response (synthetic example)
{
"id": "11111111-1111-1111-1111-111111111111",
"status": "completed",
"projectId": "22222222-2222-2222-2222-222222222222",
"requestId": "req_example",
"segments": [
{
"id": "item-1",
"text": "Good morning",
"targetLocale": "en"
}
],
"usage": {
"sourceWordCount": 2,
"billableSourceWordCount": 2,
"cachedSourceWordCount": 0,
"meter": "localization_canonical_new_work_v1",
"note": "Billable units represent newly generated canonical source content for a target locale."
}
}