Skip to content

Code Mẫu: cURL ​

Tổng hợp đầy đủ các lệnh cURL mẫu để kiểm tra và tích hợp các dịch vụ của ImageCoreAPI từ Command Line hoặc Terminal.


1. Tra Cứu Thông Tin Key & Quota ​

Kiểm tra quyền hạn sàn và hạn mức tìm kiếm còn lại:

bash
curl -X GET "https://control.ecomtools.vn/v1/me" \
  -H "X-API-Key: YOUR_API_KEY"

2. Tìm Kiếm Hình Ảnh Trên Shopee ​

Biến thể 1: Tìm kiếm bằng image_url ​

bash
curl -X POST "https://control.ecomtools.vn/v1/shopee/search" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "cookie": "SPC_EC=your_cookie_here; SPC_F=your_spc_f_here...",
    "image_url": "https://example.com/sample-product.jpg",
    "country": "VN",
    "page": 1
  }'

Biến thể 2: Tìm kiếm bằng image_key (Ảnh có sẵn trên Shopee) ​

bash
curl -X POST "https://control.ecomtools.vn/v1/shopee/search" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "cookie": "SPC_EC=your_cookie_here...",
    "image_key": "vn-11134207-7ras8-m427e1f48y0hbf",
    "country": "VN",
    "page": 1
  }'

3. Tìm Kiếm Hình Ảnh Trên TikTok Shop ​

Tìm kiếm bằng chuỗi ảnh Base64:

bash
curl -X POST "https://control.ecomtools.vn/v1/tiktok/search" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "image_base64": "/9j/4AAQSkZJRgABAQEASABIAAD/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJ..."
  }'

4. Upload Tệp Ảnh Lên TikTok CDN ​

Tải trực tiếp tệp ảnh vật lý từ máy tính lên hệ sinh thái TikTok (tối đa 12MB):

bash
curl -X POST "https://control.ecomtools.vn/v1/tiktok/upload" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@./sample_product.jpg"

5. Tìm Video Douyin Bằng Ảnh ​

Key cần được cấp quyền douyin. Gửi chuỗi Base64 thuần, không kèm tiền tố Data URL:

bash
curl -X POST "https://control.ecomtools.vn/v1/douyin/vision" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_base64":"<ANH_BASE64>"}'

Xem thêm tham số và cách xử lý phản hồi.


6. Kiểm Tra Trạng Thái Dịch Vụ (Health Check) ​

bash
curl -X GET "https://control.ecomtools.vn/v1/health"

ImageCoreAPI — Cổng API tìm kiếm hình ảnh Shopee & TikTok Shop