PHPackages                             crisnao2/meli - 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. crisnao2/meli

ActiveLibrary

crisnao2/meli
=============

MercadoLibre's PHP SDK

01.1kHTML

Since Dec 13Pushed 8y ago1 watchersCompare

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

READMEChangelogDependenciesVersions (2)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

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/3680afb6e7809f9d1e1236a2331137cf4f7c50a477a8a7b20a586aba94a3bc71?d=identicon)[crisnao2](/maintainers/crisnao2)

---

Top Contributors

[![pablomoretti](https://avatars.githubusercontent.com/u/530831?v=4)](https://github.com/pablomoretti "pablomoretti (38 commits)")[![diazmartin](https://avatars.githubusercontent.com/u/1153516?v=4)](https://github.com/diazmartin "diazmartin (32 commits)")[![Phaael](https://avatars.githubusercontent.com/u/8864507?v=4)](https://github.com/Phaael "Phaael (9 commits)")[![ZeusMode](https://avatars.githubusercontent.com/u/777842?v=4)](https://github.com/ZeusMode "ZeusMode (7 commits)")[![brunoelia](https://avatars.githubusercontent.com/u/115396?v=4)](https://github.com/brunoelia "brunoelia (6 commits)")[![TioBorracho](https://avatars.githubusercontent.com/u/345822?v=4)](https://github.com/TioBorracho "TioBorracho (3 commits)")[![rodurma](https://avatars.githubusercontent.com/u/79693?v=4)](https://github.com/rodurma "rodurma (3 commits)")[![lbertalot](https://avatars.githubusercontent.com/u/3768857?v=4)](https://github.com/lbertalot "lbertalot (3 commits)")[![morturus](https://avatars.githubusercontent.com/u/1568438?v=4)](https://github.com/morturus "morturus (2 commits)")[![rafaelsantos82](https://avatars.githubusercontent.com/u/180335726?v=4)](https://github.com/rafaelsantos82 "rafaelsantos82 (2 commits)")[![pablogumilla](https://avatars.githubusercontent.com/u/2159996?v=4)](https://github.com/pablogumilla "pablogumilla (1 commits)")[![alesandroalan](https://avatars.githubusercontent.com/u/7017456?v=4)](https://github.com/alesandroalan "alesandroalan (1 commits)")

### Embed Badge

![Health badge](/badges/crisnao2-meli/health.svg)

```
[![Health](https://phpackages.com/badges/crisnao2-meli/health.svg)](https://phpackages.com/packages/crisnao2-meli)
```

PHPackages © 2026

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