cURL
curl --request GET \
--url 'https://api.branduo.io/v1/discover/partner/recommendations' \
--header 'X-Api-Key: YOUR_API_KEY' \
--header 'X-Platform-Id: YOUR_PLATFORM_ID'
const response = await fetch("https://api.branduo.io/v1/discover/partner/recommendations", {
method: "GET",
headers: {
"X-Api-Key": "YOUR_API_KEY",
"X-Platform-Id": "YOUR_PLATFORM_ID",
},
});
const data = await response.json();
import requests
response = requests.request(
"GET",
"https://api.branduo.io/v1/discover/partner/recommendations",
headers={
"X-Api-Key": "YOUR_API_KEY",
"X-Platform-Id": "YOUR_PLATFORM_ID",
},
)
data = response.json()
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.branduo.io/v1/discover/partner/recommendations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: YOUR_API_KEY",
"X-Platform-Id: YOUR_PLATFORM_ID"
],
]);
$response = curl_exec($curl);
curl_close($curl);
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://api.branduo.io/v1/discover/partner/recommendations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "YOUR_API_KEY")
req.Header.Add("X-Platform-Id", "YOUR_PLATFORM_ID")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
require "uri"
require "net/http"
url = URI("https://api.branduo.io/v1/discover/partner/recommendations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP.const_get("GET".capitalize).new(url)
request["X-Api-Key"] = "YOUR_API_KEY"
request["X-Platform-Id"] = "YOUR_PLATFORM_ID"
response = http.request(request)
puts response.read_body
using var client = new HttpClient();
using var request = new HttpRequestMessage(
new HttpMethod("GET"),
"https://api.branduo.io/v1/discover/partner/recommendations");
request.Headers.TryAddWithoutValidation("X-Api-Key", "YOUR_API_KEY");
request.Headers.TryAddWithoutValidation("X-Platform-Id", "YOUR_PLATFORM_ID");
using var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class BranduoRequest {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.branduo.io/v1/discover/partner/recommendations"))
.header("X-Api-Key", "YOUR_API_KEY")
.header("X-Platform-Id", "YOUR_PLATFORM_ID")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
{
"data": [
{
"domain": "northwindgoods.com",
"businessName": "Northwind Goods",
"logoImageUrl": "https://example.com/logo.png",
"description": "Outdoor goods for everyday trips.",
"matchRate": 86,
"businessSize": "Medium",
"country": "United States",
"categories": ["Outdoor"],
"productCount": 12,
"platform": "shopify"
}
],
"totalRows": 1
}
{
"error": "unauthorized",
"message": "Invalid or missing API key or access token."
}
Discover
Get partner recommendations
Retrieve recommended partner brands for the authenticated brand.
GET
/
discover
/
partner
/
recommendations
cURL
curl --request GET \
--url 'https://api.branduo.io/v1/discover/partner/recommendations' \
--header 'X-Api-Key: YOUR_API_KEY' \
--header 'X-Platform-Id: YOUR_PLATFORM_ID'
const response = await fetch("https://api.branduo.io/v1/discover/partner/recommendations", {
method: "GET",
headers: {
"X-Api-Key": "YOUR_API_KEY",
"X-Platform-Id": "YOUR_PLATFORM_ID",
},
});
const data = await response.json();
import requests
response = requests.request(
"GET",
"https://api.branduo.io/v1/discover/partner/recommendations",
headers={
"X-Api-Key": "YOUR_API_KEY",
"X-Platform-Id": "YOUR_PLATFORM_ID",
},
)
data = response.json()
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.branduo.io/v1/discover/partner/recommendations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: YOUR_API_KEY",
"X-Platform-Id: YOUR_PLATFORM_ID"
],
]);
$response = curl_exec($curl);
curl_close($curl);
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://api.branduo.io/v1/discover/partner/recommendations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "YOUR_API_KEY")
req.Header.Add("X-Platform-Id", "YOUR_PLATFORM_ID")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
require "uri"
require "net/http"
url = URI("https://api.branduo.io/v1/discover/partner/recommendations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP.const_get("GET".capitalize).new(url)
request["X-Api-Key"] = "YOUR_API_KEY"
request["X-Platform-Id"] = "YOUR_PLATFORM_ID"
response = http.request(request)
puts response.read_body
using var client = new HttpClient();
using var request = new HttpRequestMessage(
new HttpMethod("GET"),
"https://api.branduo.io/v1/discover/partner/recommendations");
request.Headers.TryAddWithoutValidation("X-Api-Key", "YOUR_API_KEY");
request.Headers.TryAddWithoutValidation("X-Platform-Id", "YOUR_PLATFORM_ID");
using var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class BranduoRequest {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.branduo.io/v1/discover/partner/recommendations"))
.header("X-Api-Key", "YOUR_API_KEY")
.header("X-Platform-Id", "YOUR_PLATFORM_ID")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
{
"data": [
{
"domain": "northwindgoods.com",
"businessName": "Northwind Goods",
"logoImageUrl": "https://example.com/logo.png",
"description": "Outdoor goods for everyday trips.",
"matchRate": 86,
"businessSize": "Medium",
"country": "United States",
"categories": ["Outdoor"],
"productCount": 12,
"platform": "shopify"
}
],
"totalRows": 1
}
{
"error": "unauthorized",
"message": "Invalid or missing API key or access token."
}
Returns the current set of recommended partner brands for the authenticated brand.
This response uses
data and totalRows. It does not accept pageIndex or pageSize.
cURL
curl --request GET \
--url 'https://api.branduo.io/v1/discover/partner/recommendations' \
--header 'X-Api-Key: YOUR_API_KEY' \
--header 'X-Platform-Id: YOUR_PLATFORM_ID'
const response = await fetch("https://api.branduo.io/v1/discover/partner/recommendations", {
method: "GET",
headers: {
"X-Api-Key": "YOUR_API_KEY",
"X-Platform-Id": "YOUR_PLATFORM_ID",
},
});
const data = await response.json();
import requests
response = requests.request(
"GET",
"https://api.branduo.io/v1/discover/partner/recommendations",
headers={
"X-Api-Key": "YOUR_API_KEY",
"X-Platform-Id": "YOUR_PLATFORM_ID",
},
)
data = response.json()
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.branduo.io/v1/discover/partner/recommendations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: YOUR_API_KEY",
"X-Platform-Id: YOUR_PLATFORM_ID"
],
]);
$response = curl_exec($curl);
curl_close($curl);
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://api.branduo.io/v1/discover/partner/recommendations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "YOUR_API_KEY")
req.Header.Add("X-Platform-Id", "YOUR_PLATFORM_ID")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
require "uri"
require "net/http"
url = URI("https://api.branduo.io/v1/discover/partner/recommendations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP.const_get("GET".capitalize).new(url)
request["X-Api-Key"] = "YOUR_API_KEY"
request["X-Platform-Id"] = "YOUR_PLATFORM_ID"
response = http.request(request)
puts response.read_body
using var client = new HttpClient();
using var request = new HttpRequestMessage(
new HttpMethod("GET"),
"https://api.branduo.io/v1/discover/partner/recommendations");
request.Headers.TryAddWithoutValidation("X-Api-Key", "YOUR_API_KEY");
request.Headers.TryAddWithoutValidation("X-Platform-Id", "YOUR_PLATFORM_ID");
using var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class BranduoRequest {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.branduo.io/v1/discover/partner/recommendations"))
.header("X-Api-Key", "YOUR_API_KEY")
.header("X-Platform-Id", "YOUR_PLATFORM_ID")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
Authenticate with the API key in the playground, or send an OAuth access token
in
Authorization. See Authentication.Headers
string
The platform UUID we assigned to your integration. Omit this header when we
have not assigned one.
Response
object[]
required
Recommended brands.
Show properties
Show properties
string
Brand website domain.
string
Brand name.
string
Logo URL. Omitted when the brand has no logo.
string
Short brand description. Omitted when none is available.
integer
Match score for the authenticated brand. Omitted when it has not been
scored.
string
Business size label, such as
Medium. Omitted when unknown.string
Primary country name. Omitted when unknown.
string[]
required
Category names. Empty when the brand has none.
integer
Catalog size. Omitted when unknown.
string
Commerce platform name. Omitted when unknown.
integer
required
Number of recommendations in this result.
Errors
| Status | Cause |
|---|---|
400 Bad Request | X-Platform-Id is not a UUID, or it is not an active platform. |
401 Unauthorized | The API key or access token is missing or invalid. |
500 | Recommendations could not be loaded. |
{
"data": [
{
"domain": "northwindgoods.com",
"businessName": "Northwind Goods",
"logoImageUrl": "https://example.com/logo.png",
"description": "Outdoor goods for everyday trips.",
"matchRate": 86,
"businessSize": "Medium",
"country": "United States",
"categories": ["Outdoor"],
"productCount": 12,
"platform": "shopify"
}
],
"totalRows": 1
}
{
"error": "unauthorized",
"message": "Invalid or missing API key or access token."
}

