{"id":18973703,"url":"https://github.com/64robots/walmart-api","last_synced_at":"2026-04-08T00:30:19.296Z","repository":{"id":96154387,"uuid":"125566409","full_name":"64robots/walmart-api","owner":"64robots","description":"Based on Gadoma/walmart-api-php-client","archived":false,"fork":false,"pushed_at":"2018-03-16T20:26:55.000Z","size":58,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-16T12:29:57.031Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/64robots.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-03-16T20:26:34.000Z","updated_at":"2018-03-16T20:26:58.000Z","dependencies_parsed_at":"2023-04-09T05:01:12.758Z","dependency_job_id":null,"html_url":"https://github.com/64robots/walmart-api","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/64robots%2Fwalmart-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/64robots%2Fwalmart-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/64robots%2Fwalmart-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/64robots%2Fwalmart-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/64robots","download_url":"https://codeload.github.com/64robots/walmart-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239970677,"owners_count":19727014,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-08T15:12:51.892Z","updated_at":"2026-04-08T00:30:19.236Z","avatar_url":"https://github.com/64robots.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Walmart Open API PHP client\n\n[![GitHub license](https://img.shields.io/github/license/gadoma/walmart-api-php-client.svg)](https://github.com/Gadoma/walmart-api-php-client/blob/develop/LICENSE) [![Travis build status](https://img.shields.io/travis/Gadoma/walmart-api-php-client/master.svg)](https://travis-ci.org/Gadoma/walmart-api-php-client) [![Coveralls test coverage](https://img.shields.io/coveralls/Gadoma/walmart-api-php-client/master.svg)](https://coveralls.io/github/Gadoma/walmart-api-php-client?branch=master) [![SensioLabsInsight grade](https://img.shields.io/sensiolabs/i/da616870-ae52-463f-9222-1d20482addbd.svg)](https://insight.sensiolabs.com/projects/da616870-ae52-463f-9222-1d20482addbd) [![Packagist](https://img.shields.io/packagist/v/Gadoma/walmart-api-php-client.svg?maxAge=2592000)](https://packagist.org/packages/gadoma/walmart-api-php-client) [![Packagist](https://img.shields.io/packagist/dt/Gadoma/walmart-api-php-client.svg?maxAge=2592000)](https://packagist.org/packages/gadoma/walmart-api-php-client)\n\n\n\n## Introduction\n\nWelcome to the Walmart Open API PHP Client, a [Composer](https://getcomposer.org/) package for interacting with the [Walmart Open API](https://developer.walmartlabs.com/). \n\nThis library is powered by [Guzzle 6](https://github.com/guzzle/guzzle) thus requires PHP \u003e= 5.5.0 to work.\n\nExtensive [PHPUnit](https://github.com/sebastianbergmann/phpunit) tests are provided, the builds are handled by [Travis-CI](https://travis-ci.org) and test code coverage is calculated by [Coveralls.io](https://coveralls.io).    \n\n### Contributing\n\nIf you notice any bugs or have an idea for improvements, feel free to submit a ticket to the project [Issue Tracker](https://github.com/Gadoma/walmart-api-php-client/issues).\n\nPull requests are welcome, just remember to submit them to the _develop_ branch. Any PRs to the _master_ branch will be rejected.\n\n## Installation\n\n### Composer\n\nIf you don't have Composer already available on your local system, install it first:\n\n```bash\ncurl -sS https://getcomposer.org/installer | php\n```\n\n### Manual installation\n\nCreate a _composer.json_ file and add an entry in the \"require\" section:\n\n```javascript\n{\n    \"require\": {\n        \"gadoma/walmart-api-php-client\": \"^1.0\"\n    }\n}\n```\n\nRun the below command afterwards:\n\n```bash\nphp composer.phar install\n```\n\n### Composer installation\n\nAlternatively to the above method you can just run the following:\n\n```bash\nphp composer.phar require gadoma/walmart-api-php-client:^1.0\n```\n\n## Usage\n\n### Walmart API key\n\nIn order to use the Walmart Open API you need to obtain an API key. You can get it by registering a [Walmart developer account](https://developer.walmartlabs.com/member/register).\n\n### Basic usage\n\n```php\n// composer autoload\nrequire 'vendor/autoload.php';\n\n//API credentials\n$apiKey = 'yourWalmartApiKey';\n\n//Basic components used by the Services\n$httpClient        = new \\GuzzleHttp\\Client();\n$errorHandler      = new \\WalmartApiClient\\Exception\\Handler\\ApiExceptionHandler();\n$transportService  = new \\WalmartApiClient\\Http\\TransportService($httpClient, $errorHandler, $apiUrl);\n$entityFactory     = new \\WalmartApiClient\\Factory\\EntityFactory();\n$collectionFactory = new \\WalmartApiClient\\Factory\\CollectionFactory();\n\n//Actual Services you will use for interacting with the API\n$productService  = new \\WalmartApiClient\\Service\\ProductService($transportService, $entityFactory, $collectionFactory);\n$offerService    = new \\WalmartApiClient\\Service\\OfferService($transportService, $entityFactory, $collectionFactory);\n$reviewService   = new \\WalmartApiClient\\Service\\ReviewService($transportService, $entityFactory, $collectionFactory);\n$taxonomyService = new \\WalmartApiClient\\Service\\TaxonomyService($transportService, $entityFactory, $collectionFactory);\n\n```\n\n### LinkShare Publisher Id\n\nIt is possible to provide your _LinkShare Publisher Id_ for URL tracking/attribution purposes. It is optional and you can read more about this subject on [Walmart Affiliates](https://affiliates.walmart.com/) website. To use your _LinkShare Publisher Id_ with this library, just pass it to _TransportService_ constructor in the process of creating the basic components, like shown below:   \n\n```php\n$apiKey = 'yourWalmartApiKey';\n$linkSharePublisherId = 'yourId';\n\n$httpClient        = new \\GuzzleHttp\\Client();\n$errorHandler      = new \\WalmartApiClient\\Exception\\Handler\\ApiExceptionHandler();\n$transportService  = new \\WalmartApiClient\\Http\\TransportService($httpClient, $errorHandler, $apiUrl, $linkSharePublisherId);\n\n```\n\n\n## Features\n\nEach of the available Services is a wrapper for one or more Walmart Open API services. The available methods' declarations and descriptions can be found in the [Service interfaces](https://github.com/Gadoma/walmart-api-php-client/tree/develop/src/WalmartApiClient/Service). Each of the methods returns either a single specific Entity (e.g. Product) or a Collection of Entities (e.g. Categories Collection).\n\n### Product service\n\n#### Integrates with\n\n- [Product Lookup API](https://developer.walmartlabs.com/docs/read/Home)\n- [Search API](https://developer.walmartlabs.com/docs/read/Search_API)\n- [Product Recommendation API](https://developer.walmartlabs.com/docs/read/Product_Recommendation_API)\n- [Post Browsed Products API](https://developer.walmartlabs.com/docs/read/Post_Browsed_Products_API)\n- [Trending API](https://developer.walmartlabs.com/docs/read/Trending_API)\n\n#### Available methods\n\n- getById\n- getByUpc\n- getByIds\n- getBySearch\n- getAllBySearch\n- getPostbrowsedById\n- getRecommendedById\n- getTrending\n\n### Offer service\n\n#### Integrates with\n\n- [Special Feeds API](https://developer.walmartlabs.com/docs/read/Special_Feeds)\n\n#### Available methods\n\n- getVod\n- getPreorder\n- getBestsellers\n- getRollback\n- getClearance\n- getSpecialbuy\n\n### Review service\n\n#### Integrates with\n\n- [Reviews API](https://developer.walmartlabs.com/docs/read/Reviews_Api)\n\n#### Available methods\n\n- getReviews\n\n### Store service\n\n#### Integrates with\n\n- [Store Locator API](https://developer.walmartlabs.com/docs/read/Store_Locator_API)\n\n#### Available methods\n\n- getStoresByCoordinates\n- getStoresByCity\n- getStoresByZip\n\n### Taxonomy service\n\n#### Integrates with\n\n- [Taxonomy API](https://developer.walmartlabs.com/docs/read/Taxonomy_API)\n\n#### Available methods\n\n- getCategories\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F64robots%2Fwalmart-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F64robots%2Fwalmart-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F64robots%2Fwalmart-api/lists"}