---
title: Product
slug: backyardapi/home-improvement-product-data-api/parameters/product
docTags:
createdAt: 2024-07-23T14:57:52.062Z
---
# Product Parameters
`GET` `/request`
The Product Parameters are applicable when making a request with `type=product` to retrieve details of a single product on Home Depot - the product is specified using either the `item_id` parameter or the `url` parameter (where the `url` parameter contains a link to a Home Depot product page). The parameters should be appended as querystring parameters to the Home Improvement Product Data API `GET` HTTP request.
Product details are retrieved from the [product page](https://www.homedepot.com/p/317061059) for a single product on Home Depot.
:::hint{type="info"}
**Lookup an ASIN by GTIN / ISBN / UPC / EAN**
Backyard API can automatically convert GTIN/ISBN/UPC codes to item\_ids and return product data for that GTIN. For details of how to lookup Backyard product details by GTIN/ISBN/UPC/EAN please see refer to the [guide](https://docs.trajectdata.com/backyardapi/home-improvement-product-data-api/reference/gtin-upc-to-home-improvement-item-id).
Note that Backyard API will cache the GTIN-to-ASIN mapping for 2 months. To force a new GTIN lookup (for example, if you suspect the existing mapping is stale), use the `skip_gtin_cache=true` request parameter (note that using `skip_gtin_cache=true` decrements 2 credits from your balance, instead of 1).
:::
For example, to request details a product with `item_id=317061059` the request would be:
:::CodeblockTabs
HTTP
```HTTP
https://api.backyardapi.com/request?api_key=demo&enginge=homedepot&type=product&item_id=317061059
```
```curl
curl -L --get https://api.backyardapi.com/request
-d api_key="demo"
-d engine="homedepot"
-d type="product"
-d item_id="317061059"
```
```nodejs
const axios = require('axios');
// set up the request parameters
const params = {
api_key: "demo",
engine: "homedepot",
type: "product",
item_id: "317061059"
}
// make the http GET request to Backyard API
axios.get('https://api.backyardapi.com/request', { params })
.then(response => {
// print the JSON response from Backyard API
console.log(JSON.stringify(response.data, 0, 2));
}).catch(error => {
// catch and print the error
console.log(error);
})
```
```python
import requests
import json
# set up the request parameters
params = {
'api_key': 'demo',
'engine': 'homedepot',
'type': 'product',
'item_id': '317061059'
}
# make the http GET request to Backyard API
api_result = requests.get('https://api.backyardapi.com/request', params)
# print the JSON response from Backyard API
print(json.dumps(api_result.json()))
```
```php
'demo',
'engine': 'homedepot',
'type': 'product',
'item_id': '317061059'
]);
# make the http GET request to Backyard API
$ch = curl_init(sprintf('%s?%s', 'https://api.backyardapi.com/request', $queryString));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
# the following options are required if you're using an outdated OpenSSL version
# more details: https://www.openssl.org/blog/blog/2021/09/13/LetsEncryptRootCertExpire/
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_TIMEOUT, 180);
$api_result = curl_exec($ch);
curl_close($ch);
# print the JSON response from Backyard API
echo $api_result;
?>
```
:::
***
### Product Parameters
The following parameters are available for all requests made when `type=product` .
| *`Parameter`* | *`Required`* | *`Description`* |
| ---------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *`engine`* | *`required`* | The engine of Home Improvement data to retrieve, for example `homedepot` |
| *`item_id`* | *`optional`* | The Home Improvement Item ID to retrieve product details for. |
| *`gtin`* | *`optional`* | The GTIN/ISBN/UPC code to look up a matching product on Home Improvement for. If the `gtin` parameter is supplied then the `item_id` parameter is ignored. GTIN-based requests work by looking up the GTIN/ISBN/UPC on Home Improvement first, then retrieving the product details for the first matching `item_id` . |
| *`url`* | *`optional`* | The Home Improvement product-page URL to retrieve product details from.
**Note** : If the `url` parameter is supplied then the `item_id` and `gtin` parameters are ignored (the `url` overrides other parameters). |
| *`include_html`* | *`optional`* | Determines whether raw HTML is included in the response (this can increase the size of the response). Can be set to `true` or `false` (the default). |
***
**Next Steps**
[Product Results](https://docs.trajectdata.com/backyardapi/home-improvement-product-data-api/results/product)