Image Search

Send a picture, get back the product. /image-search accepts both base64 payloads and image URLs. For a scene with several products, use Find products in an image. Pass config.collection_id to search inside a collection.

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)

Find products in an image

Send a scene photo and get catalog matches grouped by the objects in it. /experimental/find-products-in-image names the things it sees, localizes each one, and runs a catalog search per crop. For SDK examples, see Find products in image. Use this when the picture contains more than one product — a room, an outfit, a desk setup. For a photo of a single product, use /image-search above.

Alpha. The request shape and billing may change.

Billing is 1 credit for the call plus 1 credit per detected thing. filters apply to every per-thing search. limit is per thing, not across the whole response.

From an image URL

Pass any publicly accessible image URL.

import Channel3 from "@channel3/sdk";

const client = new Channel3();

const result = await client.experimental.findProductsInImage({
  image_url: "https://example.com/images/living-room.jpg",
});

for (const item of result.things) {
  console.log(item.thing, item.matches[0]?.title);
}

from channel3_sdk import Channel3

client = Channel3()

result = client.experimental.find_products_in_image(
    image_url="https://example.com/images/living-room.jpg",
)
for item in result.things:
    title = item.matches[0].title if item.matches else None
    print(item.thing, title)

curl -X POST https://api.trychannel3.com/experimental/find-products-in-image \
  -H "x-api-key: $CHANNEL3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://example.com/images/living-room.jpg"}'

From a base64 image

Upload an image directly as a base64 string — no public URL required. Provide exactly one of image_url or base64_image.

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

const client = new Channel3();

const b64 = fs.readFileSync("living-room.jpg").toString("base64");
const result = await client.experimental.findProductsInImage({
  base64_image: b64,
});

import base64
from channel3_sdk import Channel3

client = Channel3()

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

result = client.experimental.find_products_in_image(base64_image=b64)

What you get back

Each entry in things is one detected object:

Field	Meaning
`thing`	Visual noun used for detection, e.g. `"desk lamp"`
`bbox`	`[x1, y1, x2, y2]` in `image_size` pixels
`matches`	Catalog products for that crop, same shape as search

image_size is [width, height] of the image the boxes are relative to.

Getting Started

Make a Search

Get Product Data

Conversational Agent

Checkout

Pricing, Reporting, and Commissions

Build

Integrate

FAQ

Search by image URL

Search by base64 image

Find products in an image

From an image URL

From a base64 image

What you get back

​Search by image URL

​Search by base64 image

​Find products in an image

​From an image URL

​From a base64 image

​What you get back

Search by image URL

Search by base64 image

Find products in an image

From an image URL

From a base64 image

What you get back