Producto

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

La etsy_product source está diseñado 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 proporcionar salida estructurada (analizada) para páginas de productos de Etsy.

Ejemplos de solicitud

Los ejemplos de abajo ilustran cómo puedes obtener un resultado analizado de un producto de Best Buy.

cURL

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

Python

import requests
from pprint import pprint


# Estructura del payload.
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,
)

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

Node.js

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

HTTP

Toda la cadena que envíes debe estar codificada en URL.

https://realtime.oxylabs.io/v1/queries?source=etsy_product&product_id=18582664691&parse=true&access_token=12345abcde

PHP

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

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

C#

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

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

JSON

{
    "source": "etsy_product", 
    "product_id": "1858266469", 
    "parse": true
}

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

Valores de los parámetros de solicitud

Genérico

Parámetro	Descripción	Valor predeterminado
source	Configura el scraper.	etsy_product
product_id	ID de producto de 10 caracteres.	-
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 la salida diccionario de datos.	false
callback_url	URL para 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 source 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, pequeño organizador cuadrado para aretes, caja de regalo para dama 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": "Estados Unidos"
                },
                "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 en HTML

Estructura JSON

La tabla de abajo presenta una lista detallada de cada elemento de la página de 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 de producto de Etsy.	cadena
precio	El precio del producto.	flotante
title	El título del producto.	cadena
images	Arreglo de URLs de imágenes del producto.	arreglo
vendedor	El objeto del vendedor, que contiene detalles del vendedor.	objeto
reseñas	El objeto de reseñas, que contiene detalles de las reseñas.	objeto
reviews.count	La cantidad de reseñas recibidas para el producto.	entero
moneda	La moneda en la que está expresado el precio.	cadena
envío	El objeto de envío, que contiene detalles del envío.	objeto
shipping.from	El país de origen del envío.	cadena
old_price	El precio anterior del producto antes del descuento.	entero
categorías	Arreglo de objetos de categoría a los que pertenece el producto.	arreglo
categories.title	El título de la categoría.	cadena
personalizado	Indica si el producto se puede personalizar.	booleano
product_id	El identificador único del producto.	cadena
variation_count	La cantidad de variaciones disponibles para el producto.	entero
parse_status_code	El código de estado del trabajo de análisis. Puedes ver los códigos de estado del parser descritos aquí.	entero
creado_en	La marca de tiempo en que se creó el trabajo de scraping.	marca_de_tiempo
actualizado_en	La marca de tiempo en que terminó el trabajo de scraping.	marca_de_tiempo
page	El número de página en la paginación de resultados.	entero
código_de_estado	El código de estado del trabajo de scraping. Puedes ver los códigos de estado del scraper descritos aquí.	entero
parser_type	El tipo de analizador usado para extraer los datos.	entero
id_del_trabajo	El ID del trabajo asociado con el trabajo de scraping.	cadena

Vendedores

El objeto del 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.	cadena
title	El nombre del vendedor.	cadena
rating	La puntuación de valoración del vendedor.	entero
best_seller	Indica si el vendedor es un superventas.	booleano
star_seller	Indica si el vendedor es un vendedor estrella.	booleano
reviews_count (opcional)	La cantidad de reseñas del vendedor.	entero