Lens

La Google Lens API extrae resultados de búsqueda visual a partir de URLs de imagen proporcionadas. Devuelve resultados de imágenes con coincidencias visuales, títulos, URLs, dominios y más.

Nuestro google_lens la fuente le permite extraer resultados de la función Google Lens al realizar una búsqueda por imagen.

Explorar salida diccionario de datos para cada función SERP de Lens, ofreciendo una breve descripción, captura de pantalla, fragmento de código JSON analizado y una tabla que define cada campo analizado. Navegue por los detalles usando la navegación del lado derecho o desplazándose hacia abajo en la página.

Muestras de solicitud

La API envía una solicitud a la función Google Lens para recuperar datos estructurados relacionados con el contenido de una imagen.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "google_lens",
        "query": "https://www.beginningboutique.com.au/cdn/shop/files/Flossie-Pink-Maxi-Sleeveless-Dress_750x.jpg",
        "parse": "true"
    }'

import requests
from pprint import pprint

# Structure payload.
payload = {
    'source': 'google_lens',
    'query': 'https://www.beginningboutique.com.au/cdn/shop/files/Flossie-Pink-Maxi-Sleeveless-Dress_750x.jpg',
    'parse': 'true'
}

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

# Print prettified response to stdout.
pprint(response.json())

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "google_lens",
    query: "https://www.beginningboutique.com.au/cdn/shop/files/Flossie-Pink-Maxi-Sleeveless-Dress_750x.jpg",
    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();

https://realtime.oxylabs.io/v1/queries?source=google_lens&query=https%3A%2F%2Fwww.beginningboutique.com.au%2Fcdn%2Fshop%2Ffiles%2FFlossie-Pink-Maxi-Sleeveless-Dress_750x.jpg&parse=true&access_token=12345abcde

<?php

$params = array(
    'source' => 'google_lens',
    'query' => 'https://www.beginningboutique.com.au/cdn/shop/files/Flossie-Pink-Maxi-Sleeveless-Dress_750x.jpg',
    '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": "google_lens",
		"query":  "https://www.beginningboutique.com.au/cdn/shop/files/Flossie-Pink-Maxi-Sleeveless-Dress_750x.jpg",
		"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 = "google_lens",
                query = "https://www.beginningboutique.com.au/cdn/shop/files/Flossie-Pink-Maxi-Sleeveless-Dress_750x.jpg",
                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", "google_lens");
        jsonObject.put("query", "https://www.beginningboutique.com.au/cdn/shop/files/Flossie-Pink-Maxi-Sleeveless-Dress_750x.jpg");
        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 Realtime método de integración en nuestros ejemplos. Si desea usar Proxy Endpoint o asincrónico Push-Pull integración, consulte el métodos de integración sección.

Valores de parámetros de la solicitud

Genérico

Configuración básica y opciones de personalización para extraer resultados de Google Lens.

Parámetro

Descripción

Valor predeterminado

source

Establece el scraper.

google_lens

query

La URL de la imagen que se va a buscar.

render

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

parse

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

false

callback_url

URL de su 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

Adapte los resultados de búsqueda a ubicaciones geográficas e idiomas específicos.

Parámetro

Descripción

Valor predeterminado

geo_location

La ubicación geográfica para la cual se deben adaptar los resultados. Usar este parámetro correctamente es extremadamente importante para obtener los datos correctos. Para más información, lea sobre nuestras sugeridas geo_location estructuras de parámetros aquí.

locale

Accept-Language valor del encabezado que cambia el idioma de la interfaz web de la página de búsqueda de Google. Más información.

"key": "filter",

{
    "results": [
        {
            salida estructurada
                "url": "https://www.google.com/search?q=adidas&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en",
                    "source": "https://www.shutterstock.com/search/adidas"
                        {
                            "pla": {
                            "url": "https://www.pinterest.com/shopping/free-people-pink-maxi-dress/903333914404/",
                            "title": "Free People Pink Maxi Dress - Shop on Pinterest",
                            "domain": "Pinterest",
                            "pos_overall": 1,
                            "url_thumbnail": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcR5hGHj6ima-cDFEYeMNi-7ngOomqkHz_1Joc4_DVA5gDTprXGJ"
                        },
                        ...
                        {
                            "pos": 59,
                            "url": "https://www.jjshouse.com/Sheath-Column-One-Shoulder-Floor-Length-Chiffon-Junior-Bridesmaid-Dress-With-Ruffle-Lace-Beading-009119572-g119572",
                            "title": "Sheath/Column One-Shoulder Floor-Length Chiffon Junior Bridesmaid Dress With Ruffle Lace Beading",
                            "domain": "JJsHouse.com",
                            "pos_overall": 59,
                            "url_thumbnail": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcR8evuMBA8z7Aa8mcYh97Y2hbpB3YIEV0ZSs2gkpYIyF3pmyj_X"
                        }
                    ],
                    "total_results_count": 59
                },
                "parse_status_code": 12000
            },
            "created_at": "2024-03-13 15:07:42",
            "updated_at": "2024-03-13 15:07:45",
            "content": {
            "url": "https://lens.google.com/uploadbyurl?url=https://www.beginningboutique.com.au/cdn/shop/files/Flossie-Pink-Maxi-Sleeveless-Dress_750x.jpg&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en",
            "job_id": "7173696230097183745",
            "status_code": 200,
            "parser_type": ""
        }
    ],
}

Diccionario de datos de salida

Estructura JSON

Esta tabla describe los elementos clave de un resultado de búsqueda de Google Lens. La tabla a continuación presenta una lista detallada de cada función SERP que analizamos, junto con su descripción y tipo de dato. La tabla también incluye algunos metadatos.

Clave

Descripción

Tipo

resultados

Un diccionario que contiene los resultados de la búsqueda.

array

results.organic

Una lista de resultados de imagen no pagados con sus respectivos detalles.

array

total_results_count

El número total de resultados encontrados para la URL de la imagen.

integer

parse_status_code

El código de estado del trabajo de análisis. Puede 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

Raspe múltiples páginas usando la misma dirección IP y sesión (conjunto de cookies). Al especificar los números de página en un array JSON con la

Número de página relativo a la paginación del SERP de Google.

integer

job_id

El ID del trabajo asociado con el trabajo de scraping.

string

status_code

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

integer

Orgánico

Google Lens tiene en cuenta múltiples factores para ofrecer la información más relevante y útil a los usuarios según el contenido de la imagen que suben.

...
{
    "pla": {
    "url": "https://www.pinterest.com/shopping/free-people-pink-maxi-dress/903333914404/",
    "title": "Free People Pink Maxi Dress - Shop on Pinterest",
    "domain": "Pinterest",
    "pos_overall": 1,
    "url_thumbnail": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcR5hGHj6ima-cDFEYeMNi-7ngOomqkHz_1Joc4_DVA5gDTprXGJ"
},
...

Clave (results.organic)

Descripción

Tipo

pos

Un indicador que denota la posición de un elemento dado entre todos los resultados de Google Lens.

integer

url

La URL del resultado de Google Lens.

string

title

El título del resultado.

string

dominio

La fuente del resultado de Google Lens.

string

pos_overall

El índice de posición del resultado de Google Lens dentro del SERP.

integer

url_thumbnail

Las imágenes en miniatura codificadas en base64 del resultado de Google Lens.

string

AnteriorViajes: Hoteles SiguienteURL

Última actualización hace 2 días

¿Te fue útil?

Buenas tardes

hashtagMuestras de solicitud

hashtagValores de parámetros de la solicitud

hashtagGenérico

hashtagLocalización

hashtag"key": "filter",

hashtagDiccionario de datos de salida

hashtagEstructura JSON

hashtagOrgánico

Muestras de solicitud

Valores de parámetros de la solicitud

Genérico

Localización

"key": "filter",

Diccionario de datos de salida

Estructura JSON

Orgánico