Category

Scrape Target category pages by taxonomy node ID, with support for store, fulfillment type, and delivery ZIP localization.

O target_category a fonte é projetada para recuperar páginas de categoria do Target com base no ID do nó da taxonomia do Target. A fonte oferece recursos de localização e permite navegar pelas categorias de produtos do Target.

Exemplos de requisição

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
    "source": "target_category",
    "category_id": "owq2q",
    "render": "html"
}'

import requests
from pprint import pprint

# Estruturar payload
payload = {
    'source': 'target_category',
    'category_id': 'owq2q',
    'render': 'html',
}

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

# Imprimir a resposta
pprint(response.json())

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "target_category",
    category_id: "owq2q",
    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();

<?php

$params = array(
    'source' => 'target_category',
    'category_id' => 'owq2q',
    '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);

package main

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

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

	payload := map[string]interface{}{
		"source":  "target_category",
		"category_id": "owq2q",
		"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))
}

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", "target_category");
        jsonObject.put("category_id", "owq2q");
        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();
    }
}

Usamos o método de integração Realtime síncrona em nossos exemplos. Se você quiser usar Proxy Endpoint ou integração assíncrona Push-Pull consulte os métodos de integração da seção.

Valores dos parâmetros da requisição

Genérico

Parâmetro

Descrição

Valor padrão

source

Define o scraper.

target_category

category_id

ID do nó da taxonomia do Target para a categoria (por exemplo, "owq2q" para controles do PlayStation 5).

render

Habilita a renderização de JavaScript quando definido como html. Mais info.

callback_url

URL do seu endpoint de callback. Mais info.

user_agent_type

Tipo de dispositivo e navegador. A lista completa pode ser encontrada aqui.

desktop

- parâmetro obrigatório

Localização

Adapte os resultados para lojas específicas, tipos de atendimento e locais de entrega.

Parâmetro

Descrição

Tipo

fulfillment_type

Defina o tipo de atendimento. Valores disponíveis: pickup, shipping, shop_in_store, same_day_delivery.

String

store_id

Defina a localização da loja.

Integer

delivery_zip

Defina o CEP de entrega.

String

Entendendo os IDs de nó do Target

O sistema de categorias do Target usa IDs de nó para identificar categorias específicas. Esses IDs de nó são identificadores exclusivos no sistema de taxonomia do Target.

Exemplos de IDs de nó

Os IDs de nó podem ser encontrados na URL da página da categoria. É a parte da URL que tem o formato N-<5 symbols> . Aqui estão alguns URLs de categoria de exemplo e seus IDs de nó correspondentes:

Controles do PlayStation 5: owq2q
- URL completa: https://www.target.com/c/playstation-5-controllers-video-games/-/N-owq2q
Acessórios do PlayStation 5: lbxgt
- URL completa: https://www.target.com/c/playstation-5-accessories/-/N-lbxgt
PlayStation 5: hj96d
- URL completa: https://www.target.com/c/playstation-5/-/N-hj96d

Formato do ID de nó

Ao usar a target_category source, você só precisa fornecer o ID do nó sem o N- prefixo. A API irá formatar a URL corretamente automaticamente.

AnteriorProduct PróximoGrainger

Atualizado há 14 dias

Isto foi útil?

Boa noite

hashtagExemplos de requisição

hashtagValores dos parâmetros da requisição

hashtagGenérico

hashtagLocalização

hashtagEntendendo os IDs de nó do Target

hashtagExemplos de IDs de nó

hashtagFormato do ID de nó