Thương mại

Công cụ mua sắm cho agent, bao gồm tìm kiếm sản phẩm trên các sàn thương mại lớn, tìm sản phẩm bằng hình ảnh, cùng tìm kiếm và chi tiết sản phẩm TikTok Shop. Gồm 4 endpoint, mỗi endpoint được bảo vệ bằng giao thức thanh toán x402 và thanh toán bằng USDC. Bạn cũng có thể kết nối các endpoint này qua MCP server để dùng giữa các agent.

Tìm kiếm sản phẩm

Khám phá sản phẩm trên Google Shopping, Amazon và eBay chỉ từ một truy vấn văn bản tự do. Truy vấn được phân tích để lấy khoảng giá, tình trạng, cách sắp xếp và các sàn mục tiêu, sau đó kết quả được chuẩn hóa về cùng một schema, loại bỏ trùng lặp giữa các sàn và xếp hạng. Giá thay đổi theo số sàn được tìm kiếm, từ $0.0067 cho một sàn đến $0.02 cho cả ba sàn.

POST /shop/search

Cũng có thể thanh toán trên Base/SKALE (USDC), Base (USDC), Robinhood (USDG), Stable (USDT0).

Tham số request

Response

Trả về results (các sản phẩm đã xếp hạng với marketplace, title, url, image, price, discount, rating, reviews_count, seller, condition, shipping và also_available_at cho cùng sản phẩm trên các sàn khác), price_summary (min/max/median), intent (cách truy vấn được phân tích) và sources (số kết quả và thời gian xử lý theo từng sàn)

Ví dụ

curl -X POST "https://api.xona-agent.com/shop/search" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "query": "cheapest refurbished airpods pro under $150 on ebay",
  "marketplaces": [],
  "price_min": 0,
  "price_max": 0,
  "condition": "new",
  "sort": "relevance",
  "country": "us",
  "limit": 20
}'

Tìm sản phẩm bằng hình ảnh

Khám phá sản phẩm từ một bức ảnh thay vì truy vấn văn bản. Google Lens nhận diện vật thể trong ảnh và các nhà bán lẻ đang bán nó, rồi chuẩn hóa về cùng schema với Tìm kiếm sản phẩm. Chế độ Identify trả về các kết quả khớp hình ảnh và tên sản phẩm được suy ra với giá $0.02; chế độ Shop còn chạy sản phẩm đó qua Google Shopping, Amazon và eBay để so sánh giá đầy đủ.

POST /shop/lens

Cũng có thể thanh toán trên Base/SKALE (USDC), Base (USDC), Robinhood (USDG), Stable (USDT0).

Tham số request

Response

Trả về results (các kết quả khớp hình ảnh đã xếp hạng theo cùng schema sản phẩm, kèm exact_match khi Google xác nhận là cùng một sản phẩm), identified (tên sản phẩm được suy ra từ các kết quả khớp hàng đầu, có thể dùng lại làm truy vấn văn bản), is_product_image (false khi ảnh chủ yếu khớp với các trang không phải bán lẻ), marketplace_comparison (chỉ ở chế độ Shop), related_queries và price_summary

Ví dụ

curl -X POST "https://api.xona-agent.com/shop/lens" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "image_url": "https://example.com/product.jpg",
  "mode": "identify",
  "q": "in black",
  "marketplaces": [],
  "price_min": 0,
  "price_max": 0,
  "condition": "new",
  "sort": "relevance",
  "country": "us",
  "limit": 20
}'

Chi tiết sản phẩm TikTok Shop

Chi tiết đầy đủ cho một sản phẩm TikTok Shop từ URL của nó. Trả về mọi thứ mà Search trả về, cộng thêm mô tả của người bán, danh mục, toàn bộ ảnh sản phẩm, thông số kỹ thuật, các biến thể có thể mua với giá và tồn kho theo từng SKU, đánh giá và vị trí của người bán, tình trạng còn hàng, và một số đánh giá mẫu của người mua kèm nội dung. Chỉ hỗ trợ cửa hàng Mỹ, nguồn upstream không cung cấp chi tiết cho khu vực nào khác, trong khi Search bao phủ cả 16 khu vực.

POST /tiktok/product

Cũng có thể thanh toán trên Base/SKALE (USDC), Base (USDC).

Tham số request

Response

Trả về product (schema sản phẩm của Search cộng thêm description, category, images, specifications, skus với giá và tồn kho theo từng biến thể, seller_detail với đánh giá và vị trí, reviews với nội dung và tác giả, và in_stock), found (false khi sản phẩm bị gỡ hoặc không truy cập được) và cached

Ví dụ

curl -X POST "https://api.xona-agent.com/tiktok/product" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "url": "https://www.tiktok.com/shop/pdp/1732469755419464435",
  "region": "US",
  "raw": false
}'

Tìm kiếm TikTok Shop

Tìm kiếm theo từ khóa trên sàn TikTok Shop, bao phủ 16 cửa hàng quốc gia. Kết quả trả về theo cùng schema chuẩn hóa với Tìm kiếm sản phẩm, nên TikTok Shop có thể được so sánh cùng Google Shopping, Amazon và eBay. Mỗi sản phẩm có giá, giá niêm yết, mức giảm giá, đánh giá, số lượng đã bán, người bán và các huy hiệu riêng của TikTok. Giá được trả về theo đơn vị tiền tệ của cửa hàng đó, không bao giờ mặc định là USD.

POST /tiktok/search

Cũng có thể thanh toán trên Base/SKALE (USDC), Base (USDC).

Tham số request

Response

Trả về results (các sản phẩm đã xếp hạng với marketplace, product_id, title, url, image, price {amount, currency}, original_price, discount_pct, rating, reviews_count, sold_count, seller, shop_id, ship_from, badges), total_results, total_available (số kết quả khớp của chính TikTok cho truy vấn), price_summary (min/max/median) và cached

Ví dụ

curl -X POST "https://api.xona-agent.com/tiktok/search" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "query": "wireless earbuds",
  "region": "US",
  "page": 1,
  "raw": false
}'