---
id: python-lokalise-api
version: "4.1.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# python-lokalise-api — Official Python interface for the Lokalise API v2

License: permissive · Maintenance: active · Downloads: 170.5K/mo

## What it is and what it does

This is the official Python interface to Lokalise's REST API v2, a service for managing translation projects and localization workflows. It wraps HTTP requests to the Lokalise backend and returns structured Python objects representing projects, translation keys, and file upload operations, eliminating the need to parse raw JSON responses manually.

You authenticate with an API token or OAuth 2 credentials, then instantiate a client and call methods like project(), keys(), and upload_file() to interact with your translation data. The library handles serialization and deserialization, making it natural to work with Lokalise resources as Python objects rather than dictionaries.

Use it for:

- Automate bulk uploads of translation files to Lokalise projects from a CI/CD pipeline.
- Retrieve and iterate over translation keys programmatically to sync with external localization systems.
- Build a custom dashboard or reporting tool that queries project metadata and translation statistics.
- Manage multiple Lokalise projects and their settings via Python scripts instead of the web UI.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python client library for the Lokalise API v2, providing object-oriented access to translation project management, file uploads, and key retrieval operations.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and is licensed permissively. Install it if you need to integrate Lokalise translation management into Python applications or automation workflows. The Python 3.10+ requirement is a hard constraint worth checking before adoption.

## Install

pip install python-lokalise-api
uv add python-lokalise-api
poetry add python-lokalise-api

## Installing python-lokalise-api

Before you install: Low install friction with only two runtime dependencies (requests and exceptiongroup). Active maintenance with a recent release 23 days ago and ongoing repository activity.

License in practice: Permissive BSD 3 Clause License allows commercial and private use with minimal restrictions.

Quickstart:

pip install python-lokalise-api

import lokalise

client = lokalise.Client('YOUR_API_TOKEN')
project = client.project('123.abc')
print(project.name)

Requires Python 3.10 or above.

Verify before relying:

- Whether OAuth 2 token support is production-ready or still experimental.
- Rate limiting behavior and handling of large pagination requests.
- Performance characteristics when working with projects containing thousands of translation keys.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 170.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

lokalise api python client, translation management api, lokalise file upload, translation keys api, localization api client, localization, rest-api-client

[View on SkillFed](https://skillfed.io/packages/python-lokalise-api) · [View on PyPI](https://pypi.org/project/python-lokalise-api/)