> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/pt-br/web-scraper-api/destinos/e-commerce/the-home-depot.md).

# The Home Depot

Aprenda como começar a fazer scraping do The Home Depot.

A Home Depot não tem uma fonte dedicada. Você coleta os dados de suas páginas usando a fonte `universal` e passando a página `url`. As páginas de produtos têm um parser dedicado: adicione `"parse": true` para receber JSON estruturado em vez do HTML da página.

{% hint style="warning" %}
Para alguns alvos, nosso sistema **força a renderização de JavaScript** mesmo que você não defina `render`; essas solicitações são contabilizadas como tráfego renderizado. A lista de alvos com renderização forçada e as instruções para desativá-la estão em [Como forçar a renderização em páginas específicas](https://developers.oxylabs.io/products/pt-br/web-scraper-api/features/js-rendering-and-browser-control.md#forcing-rendering-on-specific-pages).
{% endhint %}

<table><thead><tr><th width="148.91015625">Tipo de página</th><th width="416.44140625">Formato da URL</th><th width="71.31640625">Parser</th></tr></thead><tbody><tr><td><a href="#search"><strong>Página de pesquisa</strong></a></td><td><code>https://www.homedepot.com/s/&#x3C;search-term></code></td><td>Não</td></tr><tr><td><a href="#product"><strong>Página de produto</strong></a></td><td><code>https://www.homedepot.com/p/&#x3C;product-name>/&#x3C;product-id></code></td><td>Sim</td></tr><tr><td><a href="#category"><strong>Página de categoria</strong></a></td><td><code>https://www.homedepot.com/b/&#x3C;category-path>/N-&#x3C;category-id></code></td><td>Não</td></tr></tbody></table>

{% hint style="info" %}
Além dos parâmetros listados abaixo, você pode incluir parâmetros adicionais, como `user_agent_type`, `geo_location`, `render`, entre outros, para personalizar sua solicitação de coleta de dados. Saiba mais [aqui](https://developers.oxylabs.io/products/pt-br/web-scraper-api/features.md).
{% endhint %}

## Pesquisar

### Exemplos de solicitação

{% tabs %}
{% tab title="cURL" %}

```shell
curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "universal",
        "url": "https://www.homedepot.com/s/drill",
        "render": "html"
    }'
```

{% endtab %}

{% tab title="Python" %}

```python
import requests
from pprint import pprint

# Structure payload.
payload = {
    'source': 'universal',
    'url': 'https://www.homedepot.com/s/drill',
    'render': 'html'
}

# Get response.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload
)

# Instead of response with job status and results url, this will return the
# JSON response with the result.
pprint(response.json())
```

{% endtab %}

{% tab title="Node.js" %}

```javascript
const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "universal",
    url: "https://www.homedepot.com/s/drill",
    render: "html"
};

const options = {
    hostname: "realtime.oxylabs.io",
    path: "/v1/queries",
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        Authorization:
            "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
    },
};

const request = https.request(options, (response) => {
    let data = "";

    response.on("data", (chunk) => {
        data += chunk;
    });

    response.on("end", () => {
        const responseData = JSON.parse(data);
        console.log(JSON.stringify(responseData, null, 2));
    });
});

request.on("error", (error) => {
    console.error("Error:", error);
});

request.write(JSON.stringify(body));
request.end();
```

{% endtab %}

{% tab title="HTTP" %}

```http
# A string inteira enviada precisa ser codificada em URL.

https://realtime.oxylabs.io/v1/queries?source=universal&url=https://www.homedepot.com/s/drill&render=html&access_token=12345abcde
```

{% endtab %}

{% tab title="PHP" %}

```php
<?php

$params = array(
    'source' => 'universal',
    'url' => 'https://www.homedepot.com/s/drill',
    'render' => 'html'
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD");

$headers = array();
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);
```

{% endtab %}

{% tab title="Golang" %}

```go
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    const Username = "USERNAME"
    const Password = "PASSWORD"

    payload := map[string]interface{}{
        "source": "universal",
        "url": "https://www.homedepot.com/s/drill",
        "render": "html",
    }

    jsonValue, _ := json.Marshal(payload)

    client := &http.Client{}
    request, _ := http.NewRequest("POST",
        "https://realtime.oxylabs.io/v1/queries",
        bytes.NewBuffer(jsonValue),
    )

    request.SetBasicAuth(Username, Password)
    response, _ := client.Do(request)

    responseText, _ := ioutil.ReadAll(response.Body)
    fmt.Println(string(responseText))
}
```

{% endtab %}

{% tab title="C#" %}

```csharp
using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Json;
using System.Threading.Tasks;

namespace OxyApi
{
    class Program
    {
        static async Task Main()
        {
            const string Username = "USERNAME";
            const string Password = "PASSWORD";

            var parameters = new {
                source = "universal",
                url = "https://www.homedepot.com/s/drill",
                render = "html"
            };

            var client = new HttpClient();

            Uri baseUri = new Uri("https://realtime.oxylabs.io");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
            requestMessage.Content = JsonContent.Create(parameters);

            var authenticationString = $"{Username}:{Password}";
            var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();

            Console.WriteLine(contents);
        }
    }
}
```

{% endtab %}

{% tab title="Java" %}

```java
package org.example;

import okhttp3.*;
import org.json.JSONObject;
import java.util.concurrent.TimeUnit;

public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Authorization";
    public static final String USERNAME = "USERNAME";
    public static final String PASSWORD = "PASSWORD";

    public void run() {
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("source", "universal");
        jsonObject.put("url", "https://www.homedepot.com/s/drill");
        jsonObject.put("render", "html");

        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);
            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };

        var client = new OkHttpClient.Builder()
                .authenticator(authenticator)
                .readTimeout(180, TimeUnit.SECONDS)
                .build();

        var mediaType = MediaType.parse("application/json; charset=utf-8");
        var body = RequestBody.create(jsonObject.toString(), mediaType);
        var request = new Request.Builder()
                .url("https://realtime.oxylabs.io/v1/queries")
                .post(body)
                .build();

        try (var response = client.newCall(request).execute()) {
            if (response.body() != null) {
                try (var responseBody = response.body()) {
                    System.out.println(responseBody.string());
                }
            }
        } catch (Exception exception) {
            System.out.println("Error: " + exception.getMessage());
        }

        System.exit(0);
    }

    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}
```

{% endtab %}

{% tab title="JSON" %}

```json
{
    "source": "universal",
    "url": "https://www.homedepot.com/s/drill",
    "render": "html"
}
```

{% endtab %}
{% endtabs %}

### Valores dos parâmetros da solicitação

<table><thead><tr><th width="180">Parâmetro</th><th>Descrição</th><th width="160">Valor padrão</th></tr></thead><tbody><tr><td><mark style="background-color:green;"><strong><code>source</code></strong></mark></td><td>Define o scraper. As páginas da Home Depot são raspadas usando a <code>universal</code> origem.</td><td><code>universal</code></td></tr><tr><td><mark style="background-color:green;"><strong><code>url</code></strong></mark></td><td>A URL da página de pesquisa, por exemplo, <code>https://www.homedepot.com/s/drill</code>.</td><td>-</td></tr><tr><td><code>render</code></td><td>Ativa a renderização de JavaScript quando definido como <code>html</code>. Sem renderização, a maioria das solicitações de pesquisa da Home Depot falha.</td><td>-</td></tr></tbody></table>

&#x20;   \- parâmetro obrigatório

## Produto <a href="#product" id="product"></a>

### Exemplos de solicitação

{% tabs %}
{% tab title="cURL" %}

```shell
curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "universal",
        "url": "https://www.homedepot.com/p/Milwaukee-M18-18V-Lithium-Ion-Cordless-Drill-Driver-Impact-Driver-Combo-Kit-2-Tool-W-Two-1-5Ah-Batteries-Charger-Tool-Bag-2691-22/100650378",
        "parse": true
    }'
```

{% endtab %}

{% tab title="Python" %}

```python
import requests
from pprint import pprint

# Structure payload.
payload = {
    'source': 'universal',
    'url': 'https://www.homedepot.com/p/Milwaukee-M18-18V-Lithium-Ion-Cordless-Drill-Driver-Impact-Driver-Combo-Kit-2-Tool-W-Two-1-5Ah-Batteries-Charger-Tool-Bag-2691-22/100650378',
    'parse': True
}

# Get response.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload
)

# Instead of response with job status and results url, this will return the
# JSON response with the result.
pprint(response.json())
```

{% endtab %}

{% tab title="Node.js" %}

```javascript
const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "universal",
    url: "https://www.homedepot.com/p/Milwaukee-M18-18V-Lithium-Ion-Cordless-Drill-Driver-Impact-Driver-Combo-Kit-2-Tool-W-Two-1-5Ah-Batteries-Charger-Tool-Bag-2691-22/100650378",
    parse: true
};

const options = {
    hostname: "realtime.oxylabs.io",
    path: "/v1/queries",
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        Authorization:
            "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
    },
};

const request = https.request(options, (response) => {
    let data = "";

    response.on("data", (chunk) => {
        data += chunk;
    });

    response.on("end", () => {
        const responseData = JSON.parse(data);
        console.log(JSON.stringify(responseData, null, 2));
    });
});

request.on("error", (error) => {
    console.error("Error:", error);
});

request.write(JSON.stringify(body));
request.end();
```

{% endtab %}

{% tab title="HTTP" %}

```http
# A string inteira enviada precisa ser codificada em URL.

https://realtime.oxylabs.io/v1/queries?source=universal&url=https://www.homedepot.com/p/Milwaukee-M18-18V-Lithium-Ion-Cordless-Drill-Driver-Impact-Driver-Combo-Kit-2-Tool-W-Two-1-5Ah-Batteries-Charger-Tool-Bag-2691-22/100650378&parse=true&access_token=12345abcde
```

{% endtab %}

{% tab title="PHP" %}

```php
<?php

$params = array(
    'source' => 'universal',
    'url' => 'https://www.homedepot.com/p/Milwaukee-M18-18V-Lithium-Ion-Cordless-Drill-Driver-Impact-Driver-Combo-Kit-2-Tool-W-Two-1-5Ah-Batteries-Charger-Tool-Bag-2691-22/100650378',
    'parse' => true
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD");

$headers = array();
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);
```

{% endtab %}

{% tab title="Golang" %}

```go
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    const Username = "USERNAME"
    const Password = "PASSWORD"

    payload := map[string]interface{}{
        "source": "universal",
        "url": "https://www.homedepot.com/p/Milwaukee-M18-18V-Lithium-Ion-Cordless-Drill-Driver-Impact-Driver-Combo-Kit-2-Tool-W-Two-1-5Ah-Batteries-Charger-Tool-Bag-2691-22/100650378",
        "parse": true,
    }

    jsonValue, _ := json.Marshal(payload)

    client := &http.Client{}
    request, _ := http.NewRequest("POST",
        "https://realtime.oxylabs.io/v1/queries",
        bytes.NewBuffer(jsonValue),
    )

    request.SetBasicAuth(Username, Password)
    response, _ := client.Do(request)

    responseText, _ := ioutil.ReadAll(response.Body)
    fmt.Println(string(responseText))
}
```

{% endtab %}

{% tab title="C#" %}

```csharp
using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Json;
using System.Threading.Tasks;

namespace OxyApi
{
    class Program
    {
        static async Task Main()
        {
            const string Username = "USERNAME";
            const string Password = "PASSWORD";

            var parameters = new {
                source = "universal",
                url = "https://www.homedepot.com/p/Milwaukee-M18-18V-Lithium-Ion-Cordless-Drill-Driver-Impact-Driver-Combo-Kit-2-Tool-W-Two-1-5Ah-Batteries-Charger-Tool-Bag-2691-22/100650378",
                parse = true
            };

            var client = new HttpClient();

            Uri baseUri = new Uri("https://realtime.oxylabs.io");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
            requestMessage.Content = JsonContent.Create(parameters);

            var authenticationString = $"{Username}:{Password}";
            var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();

            Console.WriteLine(contents);
        }
    }
}
```

{% endtab %}

{% tab title="Java" %}

```java
package org.example;

import okhttp3.*;
import org.json.JSONObject;
import java.util.concurrent.TimeUnit;

public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Authorization";
    public static final String USERNAME = "USERNAME";
    public static final String PASSWORD = "PASSWORD";

    public void run() {
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("source", "universal");
        jsonObject.put("url", "https://www.homedepot.com/p/Milwaukee-M18-18V-Lithium-Ion-Cordless-Drill-Driver-Impact-Driver-Combo-Kit-2-Tool-W-Two-1-5Ah-Batteries-Charger-Tool-Bag-2691-22/100650378");
        jsonObject.put("parse", true);

        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);
            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };

        var client = new OkHttpClient.Builder()
                .authenticator(authenticator)
                .readTimeout(180, TimeUnit.SECONDS)
                .build();

        var mediaType = MediaType.parse("application/json; charset=utf-8");
        var body = RequestBody.create(jsonObject.toString(), mediaType);
        var request = new Request.Builder()
                .url("https://realtime.oxylabs.io/v1/queries")
                .post(body)
                .build();

        try (var response = client.newCall(request).execute()) {
            if (response.body() != null) {
                try (var responseBody = response.body()) {
                    System.out.println(responseBody.string());
                }
            }
        } catch (Exception exception) {
            System.out.println("Error: " + exception.getMessage());
        }

        System.exit(0);
    }

    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}
```

{% endtab %}

{% tab title="JSON" %}

```json
{
    "source": "universal",
    "url": "https://www.homedepot.com/p/Milwaukee-M18-18V-Lithium-Ion-Cordless-Drill-Driver-Impact-Driver-Combo-Kit-2-Tool-W-Two-1-5Ah-Batteries-Charger-Tool-Bag-2691-22/100650378",
    "parse": true
}
```

{% endtab %}
{% endtabs %}

### Valores dos parâmetros da solicitação

<table><thead><tr><th width="180">Parâmetro</th><th>Descrição</th><th width="160">Valor padrão</th></tr></thead><tbody><tr><td><mark style="background-color:green;"><strong><code>source</code></strong></mark></td><td>Define o scraper. As páginas da Home Depot são raspadas usando a <code>universal</code> origem.</td><td><code>universal</code></td></tr><tr><td><mark style="background-color:green;"><strong><code>url</code></strong></mark></td><td>A URL da página do produto. A forma abreviada, contendo apenas o ID do produto, por exemplo, <code>https://www.homedepot.com/p/100650378</code>, também funciona.</td><td>-</td></tr><tr><td><code>parse</code></td><td>Retorna os dados analisados quando definido como <code>true</code>. Explore o <a href="#output-data-dictionary">dicionário de dados de saída</a>.</td><td><code>false</code></td></tr><tr><td><code>render</code></td><td>Ativa a renderização de JavaScript quando definido como <code>html</code>. Sem renderização, o Home Depot retorna a página do produto sem os detalhes de entrega.</td><td>-</td></tr><tr><td><code>context</code>: <code>store_id</code></td><td>Localização opcional da loja. Consulte <a href="#localization-and-filtering">Localização e filtragem</a>.</td><td>-</td></tr></tbody></table>

&#x20;   \- parâmetro obrigatório

### Exemplo de resposta <a href="#response-example" id="response-example"></a>

Uma página de produto analisada para o ID do produto `100650378` (listas reduzidas a um item, valores longos truncados):

<details>

<summary>Exemplo de resposta de produto do The Home Depot</summary>

```json
{
    "results": [
        {
            "content": {
                "add_to_cart": true,
                "additional_image_urls": [
                    "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86bWlsd2F1a2VldG9vbA/f84bcd2f-196a-58c8-9aec-de8e54016435"
                ],
                "answered_questions": [
                    {
                        "answer": "A bateria em si é leve, mas a ferramenta parece ter cerca do dobro do peso da versão com fio. Os pesos especificados são semelhantes. Não sei como isso pode acontecer.",
                        "question": "Qual é o peso sem a bateria?"
                    }
                ],
                "answered_questions_count": 452,
                "availability": "in_stock",
                "category": {
                    "name": "Kits combinados de ferramentas elétricas Milwaukee",
                    "url": "https://www.homedepot.com/b/Tools-Power-Tools-Power-Tool-Combo-Kits/Milwaukee/N-5yc1vZc2ecZzv"
                },
                "category_tree": [
                    {
                        "name": "Início",
                        "url": "https://www.homedepot.com/"
                    }
                ],
                "category_urls": [
                    "https://www.homedepot.com/"
                ],
                "country_code": "US",
                "currency": "USD",
                "delivery": false,
                "description": "O kit combinado de 2 ferramentas sem fio de íons de lítio Milwaukee M18 inclui a furadeira/parafusadeira compacta M18 (2606-20) e a parafusadeira de impacto M18 com encaixe sextavado de 1/4 pol. (2...",
                "details": [
                    {
                        "name": "Tipo de alimentação da bateria",
                        "value": "Íons de lítio"
                    }
                ],
                "discontinued": false,
                "domain": "https://www.homedepot.com/",
                "features": [
                    "O motor sem carcaça de 4 polos da Milwaukee apresenta um design robusto combinado com ímãs de terras raras para maior vida útil"
                ],
                "final_price": 199,
                "group_id": "100650378",
                "gtin": "0045242159338",
                "image_urls": [
                    "https://images.thdstatic.com/productImages/ed71b8cb-0cb2-4f52-ade7-f2b2e83e9c76/svn/milwaukee-power-tool-combo-kits-2691-22-64_1000.jpg"
                ],
                "in_stock": true,
                "listing_has_variations": false,
                "main_image": "https://images.thdstatic.com/productImages/ed71b8cb-0cb2-4f52-ade7-f2b2e83e9c76/svn/milwaukee-power-tool-combo-kits-2691-22-64_1000.jpg",
                "manufacturer": "Milwaukee",
                "manufacturer_description": {
                    "details": [
                        {
                            "name": "Tipo de alimentação da bateria",
                            "value": "Íons de lítio"
                        }
                    ],
                    "features": [
                        "O motor sem carcaça de 4 polos da Milwaukee apresenta um design robusto combinado com ímãs de terras raras para maior vida útil"
                    ]
                },
                "model_number": "2691-22",
                "mpn": "2691-22",
                "parent_id": "337736538",
                "parse_status_code": 12000,
                "price": "$199.00",
                "product_category": "Casa>Ferramentas>Ferramentas elétricas>Kits combinados de ferramentas elétricas>Kits combinados de ferramentas elétricas Milwaukee",
                "product_id": "100650378",
                "product_name": "Kit combinado de furadeira/parafusadeira e parafusadeira de impacto sem fio M18 18 V de íons de lítio (2 ferramentas), com duas baterias de 1,5 Ah, carregador e bolsa para ferramentas",
                "rating": 4.6,
                "related_documents": [
                    {
                        "name": "Ficha de dados de segurança",
                        "url": "https://images.thdstatic.com/catalog/pdfImages/39/39b14438-5bf1-4568-a268-062fcb9b7c8b.pdf"
                    }
                ],
                "return_policy": "https://www.homedepot.com/c/Return_Policy",
                "return_window": 90,
                "review_count": 9253,
                "reviews": [
                    {
                        "content": "[Esta avaliação foi coletada como parte de uma promoção.] Tenho uma furadeira sem escovas Milwaukee e um carregador com 2 baterias M18 CP 2.0...",
                        "max_rating": 5,
                        "min_rating": 1,
                        "rating": 5,
                        "review_id": "402310729",
                        "title": "Bom desempenho pelo preço; aceita baterias M18 mais antigas"
                    }
                ],
                "reviews_count": 9253,
                "root_category": {
                    "name": "Início",
                    "url": "https://www.homedepot.com/"
                },
                "seller_privacy_policy": "https://www.homedepot.com/privacy/privacy-and-security-statement",
                "seller_tos": "https://www.homedepot.com/c/Terms_of_Use",
                "seller_url": "https://www.homedepot.com",
                "ship_to_store": false,
                "sku": "233545",
                "star_rating": 5,
                "store_country": "US",
                "store_name": "Cumberland",
                "target_countries": [
                    "US"
                ],
                "top_reviews": [
                    {
                        "description": "[This review was collected as part of a promotion.] Having a milwaukee brushless drill and charger with 2 cp 2.0 M18 lit...",
                        "name": "DIY Al",
                        "rating": 5,
                        "title": "Bom desempenho pelo preço; aceita baterias M18 mais antigas"
                    }
                ],
                "upc": "045242159338",
                "upcgtin13": "0045242159338",
                "url": "https://www.homedepot.com/p/Milwaukee-M18-18V-Lithium-Ion-Cordless-Drill-Driver-Impact-Driver-Combo-Kit-2-Tool-W-Two-1-5Ah-Batteries-Charger-Tool-Bag-2691-22/100650378",
                "video_count": 2,
                "warranty": {
                    "available": true,
                    "length": "5 Year Warranty (Tool), 2 Year Warranty (Battery)",
                    "type": "Manufacturer Warranty"
                }
            },
            "created_at": "2026-09-28 03:37:29",
            "updated_at": "2026-09-28 03:37:35",
            "page": 1,
            "url": "https://www.homedepot.com/p/Milwaukee-M18-18V-Lithium-Ion-Cordless-Drill-Driver-Impact-Driver-Combo-Kit-2-Tool-W-Two-1-5Ah-Batteries-Charger-Tool-Bag-2691-22/100650378",
            "job_id": "7510180859647894529",
            "status_code": 200,
            "is_render_forced": false,
            "parser_type": "homedepot_product"
        }
    ]
}
```

</details>

### Dicionário de dados de saída <a href="#output-data-dictionary" id="output-data-dictionary"></a>

A tabela abaixo apresenta uma lista detalhada de cada elemento da página do produto que analisamos, juntamente com sua descrição e tipo de dado. A tabela também inclui alguns metadados.

<table><thead><tr><th width="254.33984375">Chave</th><th width="418.765625">Descrição</th><th width="90.078125">Tipo</th></tr></thead><tbody><tr><td><code>url</code></td><td>A URL da página do produto.</td><td>string</td></tr><tr><td><code>product_id</code></td><td>O ID do produto da The Home Depot, o número de 9 dígitos no final da URL do produto.</td><td>string</td></tr><tr><td><code>parent_id</code></td><td>O ID do produto pai ao qual o item pertence.</td><td>string</td></tr><tr><td><code>group_id</code></td><td>O ID do grupo de produtos.</td><td>string</td></tr><tr><td><code>sku</code></td><td>O SKU do produto na Home Depot.</td><td>string</td></tr><tr><td><code>model_number</code></td><td>O número do modelo do fabricante.</td><td>string</td></tr><tr><td><code>mpn</code></td><td>O número da peça do fabricante.</td><td>string</td></tr><tr><td><code>upc</code></td><td>O número do código de barras UPC.</td><td>string</td></tr><tr><td><code>gtin</code></td><td>O GTIN do produto.</td><td>string</td></tr><tr><td><code>upcgtin13</code></td><td>A versão GTIN de 13 dígitos do UPC.</td><td>string</td></tr><tr><td><code>product_name</code></td><td>O nome do produto.</td><td>string</td></tr><tr><td><code>manufacturer</code></td><td>A marca ou o fabricante do produto.</td><td>string</td></tr><tr><td><code>description</code></td><td>A descrição do produto.</td><td>string</td></tr><tr><td><code>features</code></td><td>Lista dos tópicos com os principais recursos do produto.</td><td>array</td></tr><tr><td><code>details</code></td><td>Lista de especificações do produto como pares de nome e valor.</td><td>array</td></tr><tr><td><code>details.name</code></td><td>O nome da especificação.</td><td>string</td></tr><tr><td><code>details.value</code></td><td>O valor da especificação.</td><td>string</td></tr><tr><td><code>manufacturer_description</code></td><td>Objeto que repete as listas <code>details</code> e <code>features</code> do fabricante.</td><td>objeto</td></tr><tr><td><code>price</code></td><td>O preço exibido na página, com o símbolo da moeda, por exemplo, <code>$199.00</code>.</td><td>string</td></tr><tr><td><code>final_price</code></td><td>O preço como número.</td><td>número de ponto flutuante</td></tr><tr><td><code>currency</code></td><td>O código de três letras da moeda segundo a norma ISO 4217.</td><td>string</td></tr><tr><td><code>availability</code></td><td>O status de disponibilidade, por exemplo, <code>in_stock</code>.</td><td>string</td></tr><tr><td><code>in_stock</code></td><td>Indica se o produto está em estoque.</td><td>booleano</td></tr><tr><td><code>discontinued</code></td><td>Indica se o produto foi descontinuado.</td><td>booleano</td></tr><tr><td><code>add_to_cart</code></td><td>Indica se o produto pode ser adicionado ao carrinho.</td><td>booleano</td></tr><tr><td><code>delivery</code></td><td>Indica se a entrega é oferecida. É preciso apenas quando a página é renderizada (<code>"render": "html"</code>); sem renderização, o valor retornado é <code>false</code>.</td><td>booleano</td></tr><tr><td><code>ship_to_store</code></td><td>Indica se é oferecida a entrega na loja. É preciso apenas quando a página é renderizada (<code>"render": "html"</code>); sem renderização, o valor retornado é <code>false</code>.</td><td>booleano</td></tr><tr><td><code>shipping_cost</code> (opcional)</td><td>Lista de custos de envio, com um objeto para cada método de entrega oferecido pelo produto: <code>ship_to_store</code>, <code>delivery</code> ou ambos. Retornado quando a página é renderizada (<code>"render": "html"</code>).</td><td>array</td></tr><tr><td><code>shipping_cost.ship_to_store</code></td><td>Custo da retirada na loja: <code>shipping_price</code> (número, <code>0</code> quando gratuito) e <code>currency</code>.</td><td>objeto</td></tr><tr><td><code>shipping_cost.delivery</code></td><td>Custo da entrega em domicílio: <code>shipping_price</code> (número, <code>0</code> quando gratuito) e <code>currency</code>.</td><td>objeto</td></tr><tr><td><code>store_name</code></td><td>O nome da loja para a qual a página foi carregada, por exemplo, <code>Hutchinson</code>.</td><td>string</td></tr><tr><td><code>zipcode</code> (opcional)</td><td>O CEP dessa loja, quando exibido.</td><td>string</td></tr><tr><td><code>store_country</code></td><td>O país da loja.</td><td>string</td></tr><tr><td><code>country_code</code></td><td>O código do país do site.</td><td>string</td></tr><tr><td><code>target_countries</code></td><td>Lista de países para os quais o produto é vendido.</td><td>array</td></tr><tr><td><code>rating</code></td><td>A avaliação média do produto.</td><td>número de ponto flutuante</td></tr><tr><td><code>star_rating</code></td><td>A avaliação arredondada para estrelas inteiras.</td><td>inteiro</td></tr><tr><td><code>review_count</code></td><td>O número de avaliações.</td><td>inteiro</td></tr><tr><td><code>reviews_count</code></td><td>O número de avaliações (o mesmo valor que <code>review_count</code>).</td><td>inteiro</td></tr><tr><td><code>reviews</code></td><td>Lista de avaliações exibidas na página.</td><td>array</td></tr><tr><td><code>reviews.review_id</code></td><td>O ID da avaliação.</td><td>string</td></tr><tr><td><code>reviews.title</code></td><td>O título da avaliação.</td><td>string</td></tr><tr><td><code>reviews.content</code></td><td>O texto da avaliação.</td><td>string</td></tr><tr><td><code>reviews.rating</code></td><td>A avaliação atribuída na avaliação.</td><td>inteiro</td></tr><tr><td><code>reviews.min_rating</code></td><td>A menor avaliação possível.</td><td>inteiro</td></tr><tr><td><code>reviews.max_rating</code></td><td>A maior avaliação possível.</td><td>inteiro</td></tr><tr><td><code>top_reviews</code></td><td>Lista das principais avaliações exibidas na página.</td><td>array</td></tr><tr><td><code>top_reviews.name</code></td><td>O nome de quem fez a avaliação.</td><td>string</td></tr><tr><td><code>top_reviews.title</code></td><td>O título da avaliação.</td><td>string</td></tr><tr><td><code>top_reviews.description</code></td><td>O texto da avaliação.</td><td>string</td></tr><tr><td><code>top_reviews.rating</code></td><td>A avaliação atribuída na avaliação.</td><td>inteiro</td></tr><tr><td><code>answered_questions</code></td><td>Lista de perguntas de clientes com respostas.</td><td>array</td></tr><tr><td><code>answered_questions.question</code></td><td>A pergunta.</td><td>string</td></tr><tr><td><code>answered_questions.answer</code></td><td>A resposta.</td><td>string</td></tr><tr><td><code>answered_questions_count</code></td><td>O número de perguntas respondidas.</td><td>inteiro</td></tr><tr><td><code>main_image</code></td><td>A URL da imagem principal do produto.</td><td>string</td></tr><tr><td><code>image_urls</code></td><td>Lista de URLs das imagens do produto.</td><td>array</td></tr><tr><td><code>additional_image_urls</code></td><td>Lista de URLs de fotos de clientes.</td><td>array</td></tr><tr><td><code>video_count</code></td><td>O número de vídeos do produto.</td><td>inteiro</td></tr><tr><td><code>category</code></td><td>A categoria do próprio produto.</td><td>objeto</td></tr><tr><td><code>category.name</code></td><td>O nome da categoria.</td><td>string</td></tr><tr><td><code>category.url</code></td><td>A URL da categoria.</td><td>string</td></tr><tr><td><code>category_tree</code></td><td>Lista de categorias, do nível mais alto até a categoria do produto.</td><td>array</td></tr><tr><td><code>category_tree.name</code></td><td>O nome da categoria.</td><td>string</td></tr><tr><td><code>category_tree.url</code></td><td>A URL da categoria.</td><td>string</td></tr><tr><td><code>category_urls</code></td><td>Lista de URLs das categorias no caminho da categoria.</td><td>array</td></tr><tr><td><code>root_category</code></td><td>A categoria de nível mais alto.</td><td>objeto</td></tr><tr><td><code>root_category.name</code></td><td>O nome da categoria de nível mais alto.</td><td>string</td></tr><tr><td><code>root_category.url</code></td><td>A URL da categoria de nível mais alto.</td><td>string</td></tr><tr><td><code>product_category</code></td><td>O caminho completo da categoria, separado por <code>></code>.</td><td>string</td></tr><tr><td><code>listing_has_variations</code></td><td>Indica se o produto tem variações.</td><td>booleano</td></tr><tr><td><code>warranty</code></td><td>Objeto com detalhes da garantia.</td><td>objeto</td></tr><tr><td><code>warranty.available</code></td><td>Indica se uma garantia é oferecida.</td><td>booleano</td></tr><tr><td><code>warranty.type</code></td><td>O tipo de garantia.</td><td>string</td></tr><tr><td><code>warranty.length</code></td><td>A duração da garantia.</td><td>string</td></tr><tr><td><code>related_documents</code></td><td>Lista de documentos do produto, como manuais ou guias.</td><td>array</td></tr><tr><td><code>related_documents.name</code></td><td>O nome do documento.</td><td>string</td></tr><tr><td><code>related_documents.url</code></td><td>A URL do documento.</td><td>string</td></tr><tr><td><code>return_window</code></td><td>O prazo para devolução, em dias.</td><td>inteiro</td></tr><tr><td><code>return_policy</code></td><td>A URL da política de devolução.</td><td>string</td></tr><tr><td><code>seller_url</code></td><td>A URL do vendedor.</td><td>string</td></tr><tr><td><code>seller_tos</code></td><td>A URL dos termos de uso do vendedor.</td><td>string</td></tr><tr><td><code>seller_privacy_policy</code></td><td>A URL da política de privacidade do vendedor.</td><td>string</td></tr><tr><td><code>domain</code></td><td>O site de onde a página foi extraída.</td><td>string</td></tr><tr><td><code>parse_status_code</code></td><td>O código de status do trabalho de análise. Você pode ver os códigos de status do analisador descritos <strong>aqui</strong>.</td><td>inteiro</td></tr><tr><td><code>created_at</code></td><td>O timestamp de criação do trabalho de scraping.</td><td>timestamp</td></tr><tr><td><code>updated_at</code></td><td>O registro de data e hora em que o trabalho de scraping foi concluído.</td><td>timestamp</td></tr><tr><td><code>page</code></td><td>O número da página na paginação dos resultados.</td><td>inteiro</td></tr><tr><td><code>status_code</code></td><td>O código de status HTTP da página extraída.</td><td>inteiro</td></tr><tr><td><code>is_render_forced</code></td><td>Indica se a renderização foi forçada para esta solicitação.</td><td>booleano</td></tr><tr><td><code>parser_type</code></td><td>O tipo de parser usado para extrair os dados, <code>homedepot_product</code>.</td><td>string</td></tr><tr><td><code>job_id</code></td><td>O ID do trabalho associado ao trabalho de scraping.</td><td>string</td></tr></tbody></table>

## Categoria

### Exemplos de solicitação

{% tabs %}
{% tab title="cURL" %}

```shell
curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "universal",
        "url": "https://www.homedepot.com/b/Tools-Power-Tools-Drills/N-5yc1vZc27f"
    }'
```

{% endtab %}

{% tab title="Python" %}

```python
import requests
from pprint import pprint

# Structure payload.
payload = {
    'source': 'universal',
    'url': 'https://www.homedepot.com/b/Tools-Power-Tools-Drills/N-5yc1vZc27f'
}

# Get response.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload
)

# Instead of response with job status and results url, this will return the
# JSON response with the result.
pprint(response.json())
```

{% endtab %}

{% tab title="Node.js" %}

```javascript
const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "universal",
    url: "https://www.homedepot.com/b/Tools-Power-Tools-Drills/N-5yc1vZc27f"
};

const options = {
    hostname: "realtime.oxylabs.io",
    path: "/v1/queries",
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        Authorization:
            "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
    },
};

const request = https.request(options, (response) => {
    let data = "";

    response.on("data", (chunk) => {
        data += chunk;
    });

    response.on("end", () => {
        const responseData = JSON.parse(data);
        console.log(JSON.stringify(responseData, null, 2));
    });
});

request.on("error", (error) => {
    console.error("Error:", error);
});

request.write(JSON.stringify(body));
request.end();
```

{% endtab %}

{% tab title="HTTP" %}

```http
# A string inteira enviada precisa ser codificada em URL.

https://realtime.oxylabs.io/v1/queries?source=universal&url=https://www.homedepot.com/b/Tools-Power-Tools-Drills/N-5yc1vZc27f&access_token=12345abcde
```

{% endtab %}

{% tab title="PHP" %}

```php
<?php

$params = array(
    'source' => 'universal',
    'url' => 'https://www.homedepot.com/b/Tools-Power-Tools-Drills/N-5yc1vZc27f'
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD");

$headers = array();
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);
```

{% endtab %}

{% tab title="Golang" %}

```go
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    const Username = "USERNAME"
    const Password = "PASSWORD"

    payload := map[string]interface{}{
        "source": "universal",
        "url": "https://www.homedepot.com/b/Tools-Power-Tools-Drills/N-5yc1vZc27f",
    }

    jsonValue, _ := json.Marshal(payload)

    client := &http.Client{}
    request, _ := http.NewRequest("POST",
        "https://realtime.oxylabs.io/v1/queries",
        bytes.NewBuffer(jsonValue),
    )

    request.SetBasicAuth(Username, Password)
    response, _ := client.Do(request)

    responseText, _ := ioutil.ReadAll(response.Body)
    fmt.Println(string(responseText))
}
```

{% endtab %}

{% tab title="C#" %}

```csharp
using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Json;
using System.Threading.Tasks;

namespace OxyApi
{
    class Program
    {
        static async Task Main()
        {
            const string Username = "USERNAME";
            const string Password = "PASSWORD";

            var parameters = new {
                source = "universal",
                url = "https://www.homedepot.com/b/Tools-Power-Tools-Drills/N-5yc1vZc27f"
            };

            var client = new HttpClient();

            Uri baseUri = new Uri("https://realtime.oxylabs.io");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
            requestMessage.Content = JsonContent.Create(parameters);

            var authenticationString = $"{Username}:{Password}";
            var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();

            Console.WriteLine(contents);
        }
    }
}
```

{% endtab %}

{% tab title="Java" %}

```java
package org.example;

import okhttp3.*;
import org.json.JSONObject;
import java.util.concurrent.TimeUnit;

public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Authorization";
    public static final String USERNAME = "USERNAME";
    public static final String PASSWORD = "PASSWORD";

    public void run() {
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("source", "universal");
        jsonObject.put("url", "https://www.homedepot.com/b/Tools-Power-Tools-Drills/N-5yc1vZc27f");

        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);
            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };

        var client = new OkHttpClient.Builder()
                .authenticator(authenticator)
                .readTimeout(180, TimeUnit.SECONDS)
                .build();

        var mediaType = MediaType.parse("application/json; charset=utf-8");
        var body = RequestBody.create(jsonObject.toString(), mediaType);
        var request = new Request.Builder()
                .url("https://realtime.oxylabs.io/v1/queries")
                .post(body)
                .build();

        try (var response = client.newCall(request).execute()) {
            if (response.body() != null) {
                try (var responseBody = response.body()) {
                    System.out.println(responseBody.string());
                }
            }
        } catch (Exception exception) {
            System.out.println("Error: " + exception.getMessage());
        }

        System.exit(0);
    }

    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}
```

{% endtab %}

{% tab title="JSON" %}

```json
{
    "source": "universal",
    "url": "https://www.homedepot.com/b/Tools-Power-Tools-Drills/N-5yc1vZc27f"
}
```

{% endtab %}
{% endtabs %}

### Valores dos parâmetros da solicitação

<table><thead><tr><th width="96">Parâmetro</th><th width="553">Descrição</th><th width="113">Valor padrão</th></tr></thead><tbody><tr><td><mark style="background-color:green;"><strong><code>source</code></strong></mark></td><td>Define o scraper. As páginas da Home Depot são raspadas usando a <code>universal</code> origem.</td><td><code>universal</code></td></tr><tr><td><mark style="background-color:green;"><strong><code>url</code></strong></mark></td><td>A URL da página da categoria, por exemplo, <code>https://www.homedepot.com/b/Tools-Power-Tools-Drills/N-5yc1vZc27f</code>.</td><td>-</td></tr></tbody></table>

&#x20;   \- parâmetro obrigatório

## Localização e filtragem <a href="#localization-and-filtering" id="localization-and-filtering"></a>

<table><thead><tr><th width="103.66796875">Parâmetro</th><th width="88.19140625">Aplica-se a</th><th width="485.5">Descrição</th><th width="83.234375">Padrão</th></tr></thead><tbody><tr><td><code>context</code>: <code>store_id</code></td><td>Páginas de produtos</td><td>Número da loja Home Depot como uma string de 4 dígitos. Encontre a loja no <a href="https://www.homedepot.com/l/storeDirectory">diretório de lojas Home Depot</a>; o número é a última parte da URL da página da loja, por exemplo, <code>homedepot.com/l/21st-South/UT/Salt-Lake-City/84115/</code><strong><code>4403</code></strong>. Adicione um zero antes de números de 3 dígitos, por exemplo, 121 → <code>"0121"</code>. O valor analisado <code>store_name</code> indica para qual loja a página foi exibida. Não combine com <code>render</code>.</td><td>-</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.oxylabs.io/products/pt-br/web-scraper-api/destinos/e-commerce/the-home-depot.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
