Image Search - Channel3

Send a picture, get back the product. /image-search accepts both base64 payloads and image URLs.

Search by image URL

Pass any publicly accessible image URL to find visually matching products.

import Channel3 from "@channel3/sdk";

const client = new Channel3();

const results = await client.products.search({
  image_url: "https://example.com/images/blue-couch.jpg",
});

console.log(results.products[0].title);

from channel3_sdk import Channel3

client = Channel3()

results = client.products.search(
    image_url="https://example.com/images/blue-couch.jpg",
)
print(results.products[0].title)

curl -X POST https://api.trychannel3.com/v1/image-search \
  -H "x-api-key: $CHANNEL3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://example.com/images/blue-couch.jpg"}'

Search by base64 image

Upload an image directly as a base64 string — no public URL required. Great for in-app camera flows or screenshots.

import fs from "node:fs";
import Channel3 from "@channel3/sdk";

const client = new Channel3();

const b64 = fs.readFileSync("shoe.jpg").toString("base64");
const results = await client.products.search({ base64_image: b64 });

console.log(results.products[0].title);

import base64
from channel3_sdk import Channel3

client = Channel3()

with open("shoe.jpg", "rb") as f:
    b64 = base64.b64encode(f.read()).decode("utf-8")

results = client.products.search(base64_image=b64)
print(results.products[0].title)

⌘I