--- title: Common slug: bigboxapi/homedepot-product-data-api/parameters/common docTags: createdAt: 2024-07-25T05:23:57.603Z --- # Common Parameters `GET` `/request` The following parameters are used to configure your request to the Home Depot Product Data API. They should be appended as querystring parameters to a `GET` HTTP request to the `/request` endpoint. For example, to request search results, for the search term `highlighter pens` , sorted by `best_seller` , on `homedepot.com` the request would be: :::CodeblockTabs HTTP ```HTTP https://api.bigboxapi.com/request?api_key=demo&type=search&search_term=lawn+mower&sort_by=best_seller ``` ```curl curl -L --get https://api.bigboxapi.com/request -d api_key="demo" -d type="search" -d search_term="lawn mower" -d sort_by="best_seller" ``` ```nodejs const axios = require('axios'); // set up the request parameters const params = { api_key: "demo", type: "search", search_term: "law mower", sort_by: "best_seller" } // make the http GET request to BigBox API axios.get('https://api.bigboxapi.com/request', { params }) .then(response => { // print the JSON response from BigBox 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', 'type': 'search', 'search_term': 'lawn mower', 'sort_by': 'best_seller' } # make the http GET request to BigBox API api_result = requests.get('https://api.bigboxapi.com/request', params) # print the JSON response from BigBox API print(json.dumps(api_result.json())) ``` ```php 'demo', 'type': 'search', 'search_term': 'lawn mower', 'sort_by': 'best_seller' ]); # make the http GET request to BigBox API $ch = curl_init(sprintf('%s?%s', 'https://api.bigboxapi.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 BigBox API echo $api_result; ?> ``` ::: :::hint{type="info"} **Request-Specific Parameters** Additional parameters are available depending on the type of request being made (as-determined by the `type` parameter). For example, if you make a request with `type=reviews` then additional [Reviews Parameters](https://docs.trajectdata.com/bigboxapi/homedepot-product-data-api/parameters/reviews), specific to `reviews` requests, are available. ::: *** ### Common Parameters The following common parameters are required for all requests to the Home Depot Product Data API. | *`Parameter`* | *`Required`* | *`Description`* | | -------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | *`api_key`* | *`required`* | The API key for your BigBox API account. | | *`type`* | *`required`* | The type of Home Depot data to retrieve. The value of the `type` parameter determines which additional parameters are available. For example, if you make a request with `type=search` then additional [Search Parameters ](https://docs.trajectdata.com/bigboxapi/homedepot-product-data-api/parameters/search), specific to `search` requests, are available.
Valid values for `type` are:
1. `search`
2. Request search results for a `search_term` or Home Depot search results page `url` . See additional [Search Parameters ](https://docs.trajectdata.com/bigboxapi/homedepot-product-data-api/parameters/search).

1. `category`
2. Request category-listing results for a `category_id` or Home Depot search results page `url` . See additional [Category Parameters ](https://docs.trajectdata.com/bigboxapi/homedepot-product-data-api/parameters/category).

1. `product`
2. Request data from a Home Depot product page via an `item_id` or Home Depot product page `url` . See additional [Product Parameters ](https://docs.trajectdata.com/bigboxapi/homedepot-product-data-api/parameters/product).

1. `reviews`
2. Request customer reviews for an `item_id` or Home Depot product page `url` . See additional [Reviews Parameters ](https://docs.trajectdata.com/bigboxapi/homedepot-product-data-api/parameters/reviews).

1. `questions`
2. Request customer questions & answers for an `item_id` or Home Depot product page `url` . See additional [Questions Parameters ](https://www.bigboxapi.com/docs/homedepot-product-data-api/parameters/questions). | | *`customer_zipcode`* | *`optional`* | Determines the specific customer zipcode location of the request. This is useful to see in-store pricing for a particular location.
To use the `customer_zipcode` parameter you must first setup the zipcode in the [zipcodes section ](https://app.bigboxapi.com/zipcodes)of the Dashboard.
For more information please see the [Customer Zipcode Reference ](https://docs.trajectdata.com/bigboxapi/zipcodes-api/overview). | | *`output`* | *`optional`* | Determines the format in which results are returned. Can be set to `json` (default) to get the results as structured JSON or `csv` to return the results in CSV format. When using `csv` you can also use the `csv_fields` parameter to specify which fields to return in the CSV. | | *`csv_fields`* | *`optional`* | Determines the fields that are returned when returning in `csv` mode (i.e. when the `output` parameter is set to `csv` ). Should be specified as a comma seperated list of fields (in nested field, dot notation, format). For more information on the `csv_fields` parameter please see the [CSV Fields Reference ](https://docs.trajectdata.com/bigboxapi/homedepot-product-data-api/reference/csv-fields). | *** **Next Steps**      [Search Parameters](https://docs.trajectdata.com/bigboxapi/homedepot-product-data-api/parameters/search)      [Category Parameters](https://docs.trajectdata.com/bigboxapi/homedepot-product-data-api/parameters/category)      [Product Parameters](https://docs.trajectdata.com/bigboxapi/homedepot-product-data-api/parameters/product)      [Reviews Parameters](https://docs.trajectdata.com/bigboxapi/homedepot-product-data-api/parameters/reviews)