PHPackages                             bestbuy/bestbuy - 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. bestbuy/bestbuy

ActiveLibrary[API Development](/categories/api)

bestbuy/bestbuy
===============

High level PHP client for the Best Buy API

v1.0.4(8y ago)118.0k5[1 issues](https://github.com/BestBuyAPIs/bestbuy-sdk-php/issues)MITPHPPHP &gt;=5.4

Since Nov 22Pushed 8y ago9 watchersCompare

[ Source](https://github.com/BestBuyAPIs/bestbuy-sdk-php)[ Packagist](https://packagist.org/packages/bestbuy/bestbuy)[ Docs](https://github.com/BestBuyAPIs/bestbuy-sdk-php)[ RSS](/packages/bestbuy-bestbuy/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependencies (5)Versions (6)Used By (0)

Best Buy SDK for PHP [![Build Status](https://camo.githubusercontent.com/988c9c6b781b43024b89ac86c3e3e2bc1036a6ef6d433d2e44c0f9220b122a89/68747470733a2f2f7365637572652e7472617669732d63692e6f72672f42657374427579415049732f626573746275792d73646b2d7068702e7376673f6272616e63683d6d6173746572)](http://travis-ci.org/BestBuyAPIs/bestbuy-sdk-php)
==================================================================================================================================================================================================================================================================================================================================================

[](#best-buy-sdk-for-php-)

[![License](https://camo.githubusercontent.com/bf5225fdcd6908b7dfb696d837085a11d5cb368174dd9afc83c17ecf125cb329/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f626573746275792f626573746275792e737667)](https://github.com/BestBuyAPIs/bestbuy-sdk-php/blob/master/LICENSE)[![Latest Stable Version](https://camo.githubusercontent.com/13c8d9e4f3c1fda01c4bf2f4fd0d7aadd24e5e95b056f595677c0af717012029/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f626573746275792f626573746275792e737667)](https://packagist.org/packages/bestbuy/bestbuy)[![Coverage Status](https://camo.githubusercontent.com/1f9bf3357c81113dfbde5eecadc573a1e8e435b24c7f980f363e636006309bf3/68747470733a2f2f696d672e736869656c64732e696f2f636f766572616c6c732f42657374427579415049732f626573746275792d73646b2d7068702e737667)](https://coveralls.io/r/BestBuyAPIs/bestbuy-sdk-php?branch=master)[![Total Downloads](https://camo.githubusercontent.com/2d12086742fbaaafa67231d73753c329df9f5a106ad03f02a43ac7c5d117295a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f626573746275792f626573746275792e737667)](https://packagist.org/packages/bestbuy/bestbuy)

This is a high-level PHP client for the [Best Buy developer API](https://developer.bestbuy.com/).

Getting Started
---------------

[](#getting-started)

1. Sign-up for a developer API Key at
2. Install the package
    - Using the command line
        `composer require bestbuy/bestbuy`
    - Using `composer.json`
        Add `"bestbuy/bestbuy": "^1.0"` inside of the *require* part of your `composer.json` file:

        ```
        "require": {
          "bestbuy/bestbuy": "^1.0"
        }
        ```
3. Use the package. There are several ways to provide the key to the `Client`:
    - Set an environment variable of `BBY_API_KEY` to your key and invoke the method
        `$bby = new \BestBuy\Client();`
    - Send the key in as a string when invoking the method
        `$bby = new \BestBuy\Client('YOURKEY');`
    - Send the key in as part of an object when invoking the method
        `$bby = new \BestBuy\Client(['key' => 'YOURKEY']);`

Documentation
-------------

[](#documentation)

- [Store Availability](#Store-Availability)
- [Product Categories](#Product-Categories)
- [Open Box Products](#Open-Box-Products)
- [Product Information](#Product-Information)
- [Product Recommendations](#Product-Recommendations)
- [Product Reviews](#Product-Reviews)
- [Stores](#Stores)
- [Version](#Version)

### Store Availability

[](#store-availability)

#### `$bby->availability(int|int[]|string $skus, int|int[]|string $stores, [array $responseConfig = []]);`

[](#bby-availabilityintintstring-skus-intintstring-stores-array-responseconfig--)

1. A single SKU/Store #
    `$bby->availability(6354884, 611);`
2. An array of SKUs/Store #s
    `$bby->availability([6354884, 69944141], [611, 281]);`
3. A valid query for SKUs/Stores
    `$bby->availability('name=Star*', 'area(55347, 25)');`

### Product Categories

[](#product-categories)

#### `$bby->categories(string $search = '', [array $responseConfig = []]);`

[](#bby-categoriesstring-search---array-responseconfig--)

1. All categories
    `$bby->categories();`
2. A single category
    `$bby->categories('cat00000');`
3. A query for categories
    `$bby->categories('name=Home*');`

### Open Box Products

[](#open-box-products)

#### `$bby->openBox(int|int[]|string $search = '', [array $responseConfig = []]);`

[](#bby-openboxintintstring-search---array-responseconfig--)

1. All open box products
    `$bby->openBox();`
2. A single product
    `$bby->openBox(6354884);`
3. An array of products
    `$bby->openBox([6354884, 69944141]);`
4. A query
    `$bby->openBox('category.id=cat00000');`

### Product Information

[](#product-information)

#### `$bby->products(int|string $search = '', [array $responseConfig = []]);`

[](#bby-productsintstring-search---array-responseconfig--)

1. All products
    `$bby->products();`
2. A single product
    `$bby->products(6354884);`
3. A query for products
    `$bby->products('name=Star*');`

### Product Recommendations

[](#product-recommendations)

#### `$bby->recommendations(string $type, int|string $categoryIdOrSku = null, [array $responseConfig = []]);`

[](#bby-recommendationsstring-type-intstring-categoryidorsku--null-array-responseconfig--)

1. Trending or Most Viewed products
    `$bby->recommendations(\BestBuy\Client::RECOMMENDATIONS_TRENDING);`
    `$bby->recommendations(\BestBuy\Client::RECOMMENDATIONS_TRENDING, 'cat00000');`
2. Similar or Also Viewed products
    `$bby->recommendations(\BestBuy\Client::RECOMMENDATIONS_SIMILAR, 6354884);`

### Product Reviews

[](#product-reviews)

#### `$bby->reviews(int|string $search = '', [array $responseConfig = []]);`

[](#bby-reviewsintstring-search---array-responseconfig--)

1. All reviews
    `$bby->reviews();`
2. A single review
    `$bby->reviews(69944141);`
3. A query for reviews
    `$bby->reviews('comment=purchase*');`

### Stores

[](#stores)

#### `$bby->stores(int|string $search = '', [array $responseConfig = []]);`

[](#bby-storesintstring-search---array-responseconfig--)

1. All stores
    `$bby->stores();`
2. A single store
    `$bby->stores(611);`
3. A query for stores
    `$bby->stores('name=eden*');`

### Version

[](#version)

#### `$bby->version();`

[](#bby-version)

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 85.7% 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 ~164 days

Total

5

Last Release

3217d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/241466e7109a5a7a534948fbc38a9ce7ba415a66ae8d5306f246c8dcba1de29c?d=identicon)[troymccabe](/maintainers/troymccabe)

![](https://avatars.githubusercontent.com/u/70704?v=4)[Eric Caron](/maintainers/ecaron)[@ecaron](https://github.com/ecaron)

---

Top Contributors

[![troymccabe](https://avatars.githubusercontent.com/u/1299743?v=4)](https://github.com/troymccabe "troymccabe (12 commits)")[![ecaron](https://avatars.githubusercontent.com/u/70704?v=4)](https://github.com/ecaron "ecaron (2 commits)")

---

Tags

apibest-buyphpsdkapiretailproduct reviewselectronicsbbyopenbest buybestbuy

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

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

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

###  Alternatives

[algolia/algoliasearch-client-php

API powering the features of Algolia.

69734.4M144](/packages/algolia-algoliasearch-client-php)[theodo-group/llphant

LLPhant is a library to help you build Generative AI applications.

1.7k371.6k6](/packages/theodo-group-llphant)[deeplcom/deepl-php

Official DeepL API Client Library

2577.0M98](/packages/deeplcom-deepl-php)[temporal/sdk

Temporal SDK

4102.7M22](/packages/temporal-sdk)[api-platform/metadata

API Resource-oriented metadata attributes and factories

244.5M182](/packages/api-platform-metadata)[wtfzdotnet/php-tmdb-api

PHP wrapper for TMDB (TheMovieDatabase) API v3. Supports two types of approaches, one modelled with repositories, models and factories. And the other by simple array access to RAW data from The Movie Database.

4262.9k](/packages/wtfzdotnet-php-tmdb-api)

PHPackages © 2026

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