Producto

Extrae datos de páginas de producto de Etsy por ID de producto, incluyendo precios, imágenes, detalles del vendedor, reseñas, envío, categorías y más.

El etsy_product la fuente está diseñada para recuperar páginas de resultados de productos de Etsy. Podemos devolver el HTML de cualquier página de Etsy que desees. Además, podemos entregar salida estructurada (analizada) para páginas de productos de Etsy.

Muestras de solicitud

Los ejemplos a continuación ilustran cómo puedes obtener un producto de Best Buy analizado.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "etsy_product", 
        "product_id": "1858266469",
        "parse": true
    }'

import requests
from pprint import pprint


# Estructurar la carga útil.
payload = {
    'source': 'etsy_product',
    'product_id': '1858266469',
    'parse': True
}

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

# En lugar de una respuesta con el estado del trabajo y la URL de resultados, esto devolverá el
# respuesta JSON con el resultado.
pprint(response.json())

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "etsy_product",
    product_id: "1858266469",
    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();

<?php

$params = array(
    'source' => 'etsy_product',
    'product_id' => '1858266469',
    '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);

package main

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

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

	payload := map[string]interface{}{
		"source":       "etsy_product",
		"product_id":   "1858266469",
		"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))
}

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 = "etsy_product",
                product_id = "1858266469",
                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);
        }
    }
}

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", "etsy_product");
        jsonObject.put("product_id", "1858266469");
        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();
    }
}

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

Valores de parámetros de solicitud

Genérico

Parámetro

Descripción

Valor predeterminado

source

Establece el scraper.

etsy_product

product_id

ID de producto de 10 símbolos.

render

Habilita el renderizado de JavaScript cuando se establece en html. Más información.

parse

Devuelve datos analizados cuando se establece en true. Explorar diccionario de salida diccionario de datos.

false

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

Datos estructurados

etsy_product la fuente puede extraer resultados de productos de Etsy en formato HTML o JSON, proporcionando datos estructurados sobre varios elementos de la página.

Ejemplo de salida

{
    "results": [
        {
            "content": {
                "url": "https://www.etsy.com/listing/1518307138/personalized-travel-jewelry-box-small",
                "price": 6.98,
                "title": "Caja de joyería de viaje personalizada, organizador pequeño cuadrado para pendientes, caja de regalos para damas de honor para hermana, amiga",
                "images": [
                    "https://i.etsystatic.com/41680084/r/il/f09928/5191407963/il_75x75.5191407963_rurr.jpg",
                    "https://i.etsystatic.com/41680084/r/il/c9a00d/5191407709/il_75x75.5191407709_nqq5.jpg",
                    "https://i.etsystatic.com/41680084/r/il/52b188/5179396963/il_75x75.5179396963_pzw9.jpg",
                    "https://i.etsystatic.com/41680084/r/il/ce5219/5191407739/il_75x75.5191407739_k1s6.jpg",
                    "https://i.etsystatic.com/41680084/r/il/23c7e1/5143187268/il_75x75.5143187268_2tsi.jpg",
                    "https://i.etsystatic.com/41680084/r/il/96f059/5143187294/il_75x75.5143187294_1swc.jpg"
                ],
                "seller": {
                    "url": "https://www.etsy.com/shop/EnchVows?ref=shop-header-name&listing_id=1518307138&from_page=listing",
                    "title": "EnchVows",
                    "rating": 4.8247,
                    "best_seller": false,
                    "star_seller": true,
                    "reviews_count": 3016
                },
                "reviews": {
                    "count": 1875
                },
                "currency": "USD",
                "shipping": {
                    "from": "United States"
                },
                "old_price": 19.95,
                "categories": [
                    {
                        "title": "Todas las categorías"
                    },
                    {
                        "title": "Joyería"
                    },
                    {
                        "title": "Almacenamiento de joyería"
                    },
                    {
                        "title": "Cajas de joyería"
                    }
                ],
                "customized": false,
                "product_id": "1518307138",
                "variation_count": 36,
                "parse_status_code": 12000
            },
            "created_at": "2024-06-13 11:59:06",
            "updated_at": "2024-06-13 11:59:13",
            "page": 1,
            "url": "https://www.etsy.com/de-en/listing/1518307138/personalized-travel-jewelry-box-small?click_key=d602fe08540deffc77a9e2c6ab6cee6d2c2ca74a:1518307138&click_sum=a7bd4b3c&ref=hp_prn-2&pro=1&sts=1",
            "job_id": "7206988452519233537",
            "status_code": 200,
            "parser_type": "etsy_product"
        }
    ]
}

Diccionario de datos de salida

Ejemplo de HTML

Estructura JSON

La tabla a continuación presenta una lista detallada de cada elemento de la página del producto que analizamos, junto con su descripción y tipo de dato. La tabla también incluye algunos metadatos.

Clave

Descripción

Tipo

url

La URL de la página del producto en Etsy.

string

price

El precio del producto.

float

title

El título del producto.

string

images

Matriz de URL a las imágenes del producto.

array

seller

El objeto vendedor, que contiene detalles del vendedor.

object

reviews

El objeto de reseñas, que contiene detalles de las reseñas.

object

reviews.count

El número de reseñas recibidas para el producto.

integer

currency

La moneda en la que se denomina el precio.

string

shipping

El objeto de envío, que contiene detalles de envío.

object

shipping.from

El país de origen del envío.

string

old_price

El precio anterior del producto antes del descuento.

integer

categories

Matriz de objetos de categoría a los que pertenece el producto.

array

categories.title

El título de la categoría.

string

customized

Indica si el producto se puede personalizar.

boolean

product_id

El identificador único del producto.

string

variation_count

El número de variaciones disponibles para el producto.

integer

parse_status_code

El código de estado del trabajo de análisis. Puedes ver los códigos de estado del parser descritos aquí.

integer

created_at

La marca de tiempo cuando se creó el trabajo de scraping.

timestamp

updated_at

La marca de tiempo cuando se finalizó el trabajo de scraping.

timestamp

page

El número de página en la paginación de resultados.

integer

status_code

El código de estado del trabajo de scraping. Puedes ver los códigos de estado del scraper descritos aquí.

integer

parser_type

El tipo de parser utilizado para extraer los datos.

integer

job_id

El ID del trabajo asociado con el trabajo de scraping.

string

Sellers

El objeto vendedor, que contiene detalles del vendedor.

...
"seller": {
    "url": "https://www.etsy.com/shop/EnchVows?ref=shop-header-name&listing_id=1518307138&from_page=listing",
    "title": "EnchVows",
    "rating": 4.8247,
    "best_seller": false,
    "star_seller": true,
    "reviews_count": 3016
},
...

Clave (Vendedor)

Descripción

Tipo

url

La URL de la página del vendedor.

string

title

El nombre del vendedor.

string

rating

La puntuación de calificación del vendedor.

integer

best_seller

Indica si el vendedor es un best seller.

boolean

star_seller

Indica si el vendedor es un star seller.

boolean

reviews_count

(opcional)

El número de reseñas del vendedor.

integer

AnteriorBúsqueda SiguienteURL

Última actualización hace 14 días

¿Te fue útil?

Buenas noches

hashtagMuestras de solicitud

hashtagValores de parámetros de solicitud

hashtagGenérico

hashtagDatos estructurados

hashtagEjemplo de salida

hashtagDiccionario de datos de salida

hashtagEjemplo de HTML

hashtagEstructura JSON

hashtagSellers

Muestras de solicitud

Valores de parámetros de solicitud

Genérico

Datos estructurados

Ejemplo de salida

Diccionario de datos de salida

Ejemplo de HTML

Estructura JSON

Sellers