PHPackages                             melibox/mercadolibre-php-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. melibox/mercadolibre-php-sdk

ActiveLibrary

melibox/mercadolibre-php-sdk
============================

https://github.com/mercadolibre/php-sdk

1.0.7(3y ago)03.6k—0%MITHTMLPHP >=5.3.0

Since Mar 10Pushed 3y agoCompare

[ Source](https://github.com/Melibox/meli-sdk)[ Packagist](https://packagist.org/packages/melibox/mercadolibre-php-sdk)[ RSS](/packages/melibox-mercadolibre-php-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)DependenciesVersions (8)Used By (0)

 [ ![Mercado Libre Developers](https://user-images.githubusercontent.com/1153516/29861072-689ec57e-8d3e-11e7-8368-dd923543258f.jpg)](http://developers.mercadolibre.com/es/)
 MercadoLibre's PHP SDK

=======================================================================================================================================================================================================

[](#------------mercadolibres-php-sdk--)

#### This is the official PHP SDK for MercadoLibre's Platform.

[](#this-is-the-official-php-sdk-for-mercadolibres-platform)

 [ ![Deploy](https://camo.githubusercontent.com/4eea217b02568cc464752586784ae247b22e99fea520a15b6f919b15934ba8ca/68747470733a2f2f7777772e6865726f6b7563646e2e636f6d2f6465706c6f792f627574746f6e2e737667) ](https://heroku.com/deploy?template=https://github.com/mercadolibre/php-sdk)

 [ ![](https://user-images.githubusercontent.com/1153516/29859906-9453b50c-8d3a-11e7-88b6-ab354d4a4908.png) ](https://heroku.com/deploy?template=https://github.com/mercadolibre/php-sdk)

How do I install it?
--------------------

[](#how-do-i-install-it)

```
   clone repository
   https://github.com/mercadolibre/php-sdk.git

```

How do I use it?
----------------

[](#how-do-i-use-it)

The first thing to do is to instance a `Meli` class. You'll need to give a `clientId` and a `clientSecret`. You can obtain both after creating your own application. For more information on this please read: [creating an application](http://developers.mercadolibre.com/application-manager/)

### Including the Lib

[](#including-the-lib)

Include the lib meli in your project

```
require '/Meli/meli.php';
```

Start the development!

### Create an instance of Meli class

[](#create-an-instance-of-meli-class)

Simple like this

```
$meli = new Meli('1234', 'a secret');
```

With this instance you can start working on MercadoLibre's APIs.

There are some design considerations worth to mention.

1. This SDK is just a thin layer on top of an http client to handle all the OAuth WebServer flow for you.
2. There is JSON parsing. this SDK will include [json](http://php.net/manual/en/book.json.php) for internal usage.
3. This SDK will include [curl](http://php.net/manual/en/book.curl.php) for internal usage.
4. If you already have the access\_token and the refresh\_token you can pass in the constructor

```
$meli = new Meli('1234', 'a secret', 'Access_Token', 'Refresh_Token');
```

How do I redirect users to authorize my application?
----------------------------------------------------

[](#how-do-i-redirect-users-to-authorize-my-application)

This is a 2 step process.

First get the link to redirect the user. This is very easy! Just:

```
$redirectUrl = $meli->getAuthUrl("http://somecallbackurl",Meli::$AUTH_URL['MLB']); //  Don't forget to change the $AUTH_URL value to match your user's Site Id.
```

This will give you the url to redirect the user. You need to specify a callback url which will be the one that the user will redirected after a successfull authrization process.

Once the user is redirected to your callback url, you'll receive in the query string, a parameter named `code`. You'll need this for the second part of the process.

```
$user = $meli->authorize($_GET['code'], 'http://somecallbackurl');
```

This will get an `access_token` and a `refresh_token` (is case your application has the `offline_access`) for your application and your user.

At this stage your are ready to make call to the API on behalf of the user.

#### Making GET calls

[](#making-get-calls)

```
$params = array('access_token' => $access_token);
$result = $meli->get('/users/me', $params);
 #If you wish , you can get an associative array with param $assoc = true Example:
$result = $meli->get('/users/me', $params, true);
```

#### Making POST calls

[](#making-post-calls)

```
$params = array('access_token' => $access_token);

  #this body will be converted into json for you
$body = array('foo' => 'bar', 'bar' => 'foo');

$response = $meli->post('/items', $body, $params);
```

#### Making PUT calls

[](#making-put-calls)

```
$params = array('access_token' => $access_token);

  #this body will be converted into json for you
$body = array('foo' => 'bar', 'bar' => 'foo');

$response = $meli->put('/items', $body, $params);
```

#### Making DELETE calls

[](#making-delete-calls)

```
$params = array('access_token' => $access_token);
$response = $meli->delete('/questions/123', $params)
```

Examples
--------

[](#examples)

Don't forget to check out our examples codes in the folder [examples](https://github.com/mercadolibre/php-sdk/tree/master/examples)

Community
---------

[](#community)

You can contact us if you have questions using the standard communication channels described in the [developer's site](http://developers.mercadolibre.com/community/)

I want to contribute!
---------------------

[](#i-want-to-contribute)

That is great! Just fork the project in github. Create a topic branch, write some code, and add some tests for your new code.

Thanks for helping!

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 80% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~107 days

Recently: every ~77 days

Total

6

Last Release

1336d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7afa3a48cf12193f871fd2ea6f97e516b9ec586d51f8f35ce6855fdfeb550aac?d=identicon)[dev-melibox](/maintainers/dev-melibox)

---

Top Contributors

[![fmangolin](https://avatars.githubusercontent.com/u/34895655?v=4)](https://github.com/fmangolin "fmangolin (8 commits)")[![FernandoMolero](https://avatars.githubusercontent.com/u/80426998?v=4)](https://github.com/FernandoMolero "FernandoMolero (2 commits)")

### Embed Badge

![Health badge](/badges/melibox-mercadolibre-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/melibox-mercadolibre-php-sdk/health.svg)](https://phpackages.com/packages/melibox-mercadolibre-php-sdk)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)