Produto

Extraia dados de páginas de produto do Etsy pelo ID do produto, incluindo preços, imagens, detalhes do vendedor, avaliações, frete, categorias e muito mais.

O etsy_product source foi projetado para recuperar páginas de resultados de produtos da Etsy. Podemos retornar o HTML de qualquer página da Etsy que você quiser. Além disso, podemos fornecer saída estruturada (analisada) para páginas de produtos da Etsy.

Exemplos de requisição

Os exemplos abaixo ilustram como você pode obter um resultado analisado de produto do 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


# Structure payload.
payload = {
    'source': 'etsy_product',
    'product_id': '1858266469',
    'parse': True
}

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

# Em vez de uma resposta com o status do job e a URL dos resultados, isto retornará a
# resposta JSON com o resultado.
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 a string que você enviar precisa estar codificada em 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 o método de integração síncrona Realtime método de integração em nossos exemplos. Se você quiser usar Proxy Endpoint ou assíncrono Push-Pull de integração, consulte a métodos de integração seção.

Valores dos parâmetros da solicitação

Genérico

Parâmetro	Descrição	Valor padrão
source	Define o scraper.	etsy_product
product_id	ID de produto de 10 caracteres.	-
render	Ativa a renderização de JavaScript quando definido como html. Mais informações.	-
parse	Retorna os dados analisados quando definido como verdadeiro. Explorar saída dicionário de dados.	false
callback_url	URL para seu endpoint de callback. Mais informações	-
user_agent_type	Tipo de dispositivo e navegador. A lista completa pode ser encontrada aqui.	desktop

- parâmetro obrigatório

Dados estruturados

etsy_product source pode extrair resultados de produtos da Etsy em formato HTML ou JSON, fornecendo dados estruturados sobre vários elementos da página.

Exemplo de saída

{
    "results": [
        {
            "content": {
                "url": "https://www.etsy.com/listing/1518307138/personalized-travel-jewelry-box-small",
                "price": 6.98,
                "title": "Caixa de joias personalizada para viagem, pequeno organizador quadrado de brincos, caixa de presente para madrinha, irmã e 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 as categorias"
                    },
                    {
                        "title": "Joias"
                    },
                    {
                        "title": "Armazenamento de joias"
                    },
                    {
                        "title": "Caixas de joias"
                    }
                ],
                "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"
        }
    ]
}

Dicionário de dados de saída

Exemplo em HTML

Estrutura JSON

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

Chave	Descrição	Tipo
url	A URL da página de produto da Etsy.	string
preço	O preço do produto.	ponto flutuante
title	O título do produto.	string
images	Lista de URLs das imagens do produto.	array
seller	O objeto seller, contendo detalhes do vendedor.	objeto
reviews	O objeto reviews, contendo detalhes das avaliações.	objeto
reviews.count	A quantidade de avaliações recebidas para o produto.	integer
moeda	A moeda na qual o preço está denominado.	string
shipping	O objeto shipping, contendo detalhes de envio.	objeto
shipping.from	O país de origem do envio.	string
old_price	O preço anterior do produto antes do desconto.	integer
categories	Lista de objetos de categoria aos quais o produto pertence.	array
categories.title	O título da categoria.	string
customized	Indica se o produto pode ser personalizado.	booleano
product_id	O identificador exclusivo do produto.	string
variation_count	A quantidade de variações disponíveis para o produto.	integer
parse_status_code	O código de status do trabalho de parsing. Você pode ver os códigos de status do parser descritos aqui.	integer
criado_em	O timestamp em que o trabalho de scraping foi criado.	carimbo_de_data_hora
atualizado_em	O timestamp em que o trabalho de scraping foi concluído.	carimbo_de_data_hora
page	O número da página na paginação dos resultados.	integer
código_de_status	O código de status do trabalho de scraping. Você pode ver os códigos de status do scraper descritos aqui.	integer
parser_type	O tipo de parser usado para extrair os dados.	integer
id_do_trabalho	O ID do trabalho associado ao trabalho de scraping.	string

Vendedores

O objeto seller, contendo detalhes do 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
},
...

Chave (Vendedor)	Descrição	Tipo
url	A URL da página do vendedor.	string
title	O nome do vendedor.	string
rating	A pontuação de avaliação do vendedor.	integer
best_seller	Indica se o vendedor é um best seller.	booleano
star_seller	Indica se o vendedor é um star seller.	booleano
reviews_count (opcional)	A quantidade de avaliações do vendedor.	integer