Find similar brands
curl --request GET \
--url https://api.tastelabs.com/search/similar \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.tastelabs.com/search/similar"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.tastelabs.com/search/similar', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tastelabs.com/search/similar",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.tastelabs.com/search/similar"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.tastelabs.com/search/similar")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tastelabs.com/search/similar")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"results": [
{
"url": "<string>",
"identity_paragraph": "<string>",
"brand_name": "<string>",
"match": "strong",
"reason": "<string>",
"badge": "discovery",
"tags": [
"<string>"
],
"palette": {},
"typography": {},
"screenshot_url": "<string>"
}
]
}{
"detail": {
"error": "UNAUTHORIZED",
"message": "Bearer token or X-API-Key required"
}
}{
"detail": {
"error": "INSUFFICIENT_CREDITS",
"message": "Not enough credits for this request.",
"balance": 0,
"required": 1
}
}{
"detail": {
"error": "NOT_FOUND",
"message": "No completed extraction for that submission."
}
}"Internal Server Error"{
"detail": "Search failed."
}Brand search
Find similar brands
Returns brands from the corpus that look like one of your completed extractions, as the same result cards as POST /search.
Runs synchronously. Consumes credits, refunded if the request fails. The submission must be completed and readable by the caller.
Neighbours are computed fresh on every call, so they can vary slightly between calls for the same submission.
GET
/
search
/
similar
Find similar brands
curl --request GET \
--url https://api.tastelabs.com/search/similar \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.tastelabs.com/search/similar"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.tastelabs.com/search/similar', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tastelabs.com/search/similar",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.tastelabs.com/search/similar"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.tastelabs.com/search/similar")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tastelabs.com/search/similar")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"results": [
{
"url": "<string>",
"identity_paragraph": "<string>",
"brand_name": "<string>",
"match": "strong",
"reason": "<string>",
"badge": "discovery",
"tags": [
"<string>"
],
"palette": {},
"typography": {},
"screenshot_url": "<string>"
}
]
}{
"detail": {
"error": "UNAUTHORIZED",
"message": "Bearer token or X-API-Key required"
}
}{
"detail": {
"error": "INSUFFICIENT_CREDITS",
"message": "Not enough credits for this request.",
"balance": 0,
"required": 1
}
}{
"detail": {
"error": "NOT_FOUND",
"message": "No completed extraction for that submission."
}
}"Internal Server Error"{
"detail": "Search failed."
}Authorizations
API key issued by the Taste Engine. Create one in the dashboard at https://engine.tastelabs.com/app/api-keys.
Query Parameters
A completed submission of yours whose visual neighbours you want.
Minimum string length:
1Maximum number of results to return.
Required range:
1 <= x <= 30Response
Brands visually similar to the submission.
Nearest visual neighbours, closest first.
Show child attributes
Show child attributes
Was this page helpful?

