PHPackages                             micheldamasceno/mercadolibre - 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. [API Development](/categories/api)
4. /
5. micheldamasceno/mercadolibre

ActiveLibary[API Development](/categories/api)

micheldamasceno/mercadolibre
============================

Package mercadolibre

16HTML

Since Oct 4Pushed 8y ago1 watchersCompare

[ Source](https://github.com/SunstoneDevs/mercadolibre)[ Packagist](https://packagist.org/packages/micheldamasceno/mercadolibre)[ RSS](/packages/micheldamasceno-mercadolibre/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependenciesVersions (1)Used By (0)

MercadoLibre's PHP SDK
======================

[](#mercadolibres-php-sdk)

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

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 set the autentication URL of your country.
```

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

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity41

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/14fd783584297224b8f638be0d2972384951fc5c8bdb59fe56fa11b9f6c02113?d=identicon)[SunstoneDevs](/maintainers/SunstoneDevs)

---

Top Contributors

[![pablomoretti](https://avatars.githubusercontent.com/u/530831?v=4)](https://github.com/pablomoretti "pablomoretti (38 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 (6 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)")[![lbertalot](https://avatars.githubusercontent.com/u/3768857?v=4)](https://github.com/lbertalot "lbertalot (3 commits)")[![rodurma](https://avatars.githubusercontent.com/u/79693?v=4)](https://github.com/rodurma "rodurma (3 commits)")[![SunstoneDevs](https://avatars.githubusercontent.com/u/19959449?v=4)](https://github.com/SunstoneDevs "SunstoneDevs (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)")[![alesandroalan](https://avatars.githubusercontent.com/u/7017456?v=4)](https://github.com/alesandroalan "alesandroalan (1 commits)")[![pablogumilla](https://avatars.githubusercontent.com/u/2159996?v=4)](https://github.com/pablogumilla "pablogumilla (1 commits)")

### Embed Badge

![Health badge](/badges/micheldamasceno-mercadolibre/health.svg)

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

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

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