Identify Product From Image
Reverse image search for products. Given a publicly reachable image URL, returns ranked visual matches with title, source page link, and (when available) price, rating, and stock signal. Matches that resolve to Amazon or Walmart product pages are normalized to a canonical productUrl that feeds directly into get-product-details and order-product. Ideal for: turning a photo of a real-world item into a buyable product, building visual shopping flows, finding the source of an item seen in a social-media image.
Catalog action Integrations
Reverse image search for products. Given a publicly reachable image URL, returns ranked visual matches with title, source page link, and (when available) price, rating, and stock signal. Matches that resolve to Amazon or Walmart product pages are normalized to a canonical productUrl that feeds directly into get-product-details and order-product. Ideal for: turning a photo of a real-world item into a buyable product, building visual shopping flows, finding the source of an item seen in a social-media image.
At a Glance
| Field | Value |
|---|---|
| Action ID | identify-product-from-image |
| Category | Integrations |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | shopping, products, search, ecommerce, read |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
imageUrl | string | Yes | Publicly reachable HTTPS URL of the image to identify (e.g. an IPFS gateway URL or CDN-hosted image). The vendor fetches the image server-side, so signed short-lived URLs (Slack/Linear attachments, presigned S3) work only while the signature is valid. Data: URLs and localhost URLs are not supported. |
limit | integer | No | Maximum number of matches to return, in vendor ranking order. Default 3, min 1, max 10. |
country | string | No | ISO 3166-1 alpha-2 country code biasing the result region (e.g. 'us', 'gb'). Default 'us'. Affects which storefronts and currencies are surfaced. |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
imageUrl | string | Yes | The image URL that was searched. |
results | array | Yes | Ranked visual matches. Each entry includes the source page link and, when available, a normalized Amazon/Walmart productUrl that pipes directly into get-product-details and order-product. |
Examples
json{ "type": "identify-product-from-image", "payload": { "imageUrl": "https://example.com/webhook" }, "children": []}
bashcurl -X POST "https://api.b3os.org/v1/actions/identify-product-from-image/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "imageUrl": "https://example.com/webhook" }}'
Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.