A PHP library to interface with the Gengo API for translation.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
tests Fix order failing test (#57) Jun 13, 2018
.php_cs update php-cs-fixer to keep package declaration Sep 30, 2016
.travis.yml Fix 0% coverage sent to codeclimate (#59) Jun 13, 2018
LICENSE.txt Gengo PHP API 3.0.0 Aug 29, 2016
README.md Send code coverage to codeclimate (#56) Jun 13, 2018
changelog.md Fix missing order level comment (#53) Jul 11, 2017
composer.json Fix 0% coverage sent to codeclimate (#59) Jun 13, 2018
phpunit.xml Send code coverage to codeclimate (#56) Jun 13, 2018


Build Status Maintainability Test Coverage

Gengo PHP Library (for the Gengo API)

Translating your tools and products helps people all over the world access them; this is, of course, a somewhat tricky problem to solve. Gengo is a service that offers human-translation (which is often a higher quality than machine translation), and an API to manage sending in work and watching jobs. This is a PHP interface to make using the API simpler (some would say incredibly easy).

This package contains both a client library for accessing the Gengo Translate API, as well as some example code showing how to use the library.

Installation & Requirements

Installing the library is simple. Just add it to "require" of your composer.json

composer require gengo/gengo

Then inside of your code you can call:


$job1 = array(
    "type"     => "text",
    "slug"     => "API Liverpool 1",
    "body_src" => "Liverpool_1 Football Club is an English Premier League football club based in Liverpool, Merseyside.",
    "lc_src"   => "en",
    "lc_tgt"   => "ja",
    "tier"     => "standard",
    "force"    => 1,

$jobs = array("job_01" => $job1);

$api = new \Gengo\Jobs();
$response = json_decode($api->getResponseBody(), true);

When you are ready to go live insert the following before calls to Gengo:


You can read through files in tests folder for more usage examples.

Question, Comments, Complaints, Praise?

If you have questions or comments and would like to reach us directly, please feel free to do so at the following outlets. We love hearing from developers!

  • Email: api [at] gengo dot com
  • Twitter: @gengoit
  • IRC: #gengo

If you come across any issues, please file them on the Github project issue tracker. Thanks!


Check out the full Gengo API documentation.