Categoría

Extrae páginas de categoría de Target por ID de nodo de taxonomía, con soporte para tienda, tipo de cumplimiento y localización por ZIP de entrega.

El target_category source está diseñado para recuperar páginas de categorías de Target basadas en el ID de nodo de taxonomía de Target. La fuente admite funciones de localización y te permite navegar por las categorías de productos de Target.

Ejemplos de solicitud

cURL

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

Python

import requests
from pprint import pprint

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

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

# Print the response
pprint(response.json())

Node.js

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();

HTTP

# The whole string you submit has to be URL-encoded.

https://realtime.oxylabs.io/v1/queries?source=target_category&category_id=owq2q&render=html&access_token=12345abcde

PHP

<?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);

Golang

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))
}

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", "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();
    }
}

JSON

{
    "source": "target_category",
    "category_id": "owq2q",
    "render": "html"
}

Usamos el método de integración síncrona Realtime en nuestros ejemplos. Si deseas usar Proxy Endpoint o la integración asíncrona Push-Pull , consulta la sección de métodos de integración .

Valores de los parámetros de solicitud

General

Parámetro	Descripción	Valor predeterminado
source	Establece el scraper.	target_category
category_id	ID de nodo de taxonomía de Target para la categoría (por ejemplo, "owq2q" para los controles de PlayStation 5).	-
render	Habilita el renderizado de JavaScript cuando se establece en html. Más información.	-
callback_url	URL de tu endpoint de callback. Más información	-
user_agent_type	Tipo de dispositivo y navegador. La lista completa se puede encontrar aquí.	desktop

- parámetro obligatorio

Localización

Adapta los resultados a tiendas específicas, tipos de fulfillment y ubicaciones de entrega.

Parámetro	Descripción	Tipo
fulfillment_type	Establece el tipo de fulfillment. Los valores disponibles son: pickup, shipping, shop_in_store, same_day_delivery.	Cadena
store_id	Establece la ubicación de la tienda.	Entero
delivery_zip	Establece la ubicación de envío.	Cadena

Comprender los ID de nodo de Target

El sistema de categorías de Target usa ID de nodo para identificar categorías específicas. Estos ID de nodo son identificadores únicos en el sistema de taxonomía de Target.

Ejemplos de ID de nodo

Los ID de nodo se pueden encontrar en la URL de la página de categoría. Es la parte de la URL que tiene el formato N-<5 symbols> . Aquí tienes algunas URLs de ejemplo de categorías y sus ID de nodo correspondientes:

1. Controles de PlayStation 5: owq2q

   • URL completa: https://www.target.com/c/playstation-5-controllers-video-games/-/N-owq2q
2. Accesorios de PlayStation 5: lbxgt

   • URL completa: https://www.target.com/c/playstation-5-accessories/-/N-lbxgt
3. PlayStation 5: hj96d

   • URL completa: https://www.target.com/c/playstation-5/-/N-hj96d

Formato de ID de nodo

Al usar la target_category source, solo necesitas proporcionar el ID de nodo sin el N- prefijo. La API formateará automáticamente la URL correctamente.