Vision (v2)

POST https://api.pricehero.ai/v2/vision

Legacy. Prefer v3 vision identify for new integrations.

Identify a luxury item from an image. Always includes taxonomy and pricing data. Provide url or base64 (if both are set, url is used).

Request

Image URL

curl -X POST https://api.pricehero.ai/v2/vision \
  -H "Authorization: Bearer ph_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/my-bag.jpg"
  }'

From base64

curl -X POST https://api.pricehero.ai/v2/vision \
  -H "Authorization: Bearer ph_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "base64": "data:image/jpeg;base64,/9j/4AAQ..."
  }'

Body parameters

Parameter	Type	Required	Description
`url`	string	One of these	Public image URL (JPEG, PNG)
`base64`	string	One of these	Base64 image (`data:image/...;base64,...` or raw); JPEG/PNG/WebP

Send at least one of url or base64. If both are present, url is used (same as the API).

Response

{
  "success": true,
  "results": [
    {
      "label": "Louis Vuitton Speedy 30 Monogram",
      "confidence": 0.91,
      "id": "product_K9xLpQ2vZrT7mN4cHs8YbEwUdA1FgR6jX0qP",
      "product": {
        "id": "product_K9xLpQ2vZrT7mN4cHs8YbEwUdA1FgR6jX0qP",
        "updated_at": "2026-03-15T12:00:00Z",
        "category_id": "handbags",
        "attributes": [
          {
            "field": "brand",
            "id": "brand_R7xVn3LpQ2sK8mTzH5YwE9aU4FbG1JdC6uN",
            "name": "Louis Vuitton"
          }
        ],
        "variants": [
          {
            "id": "variant_Z4mQx8TnLpR2sV7cHk9YwE5aU1FbG6JdC3uN",
            "fields": [{ "field": "size", "name": "Medium" }],
            "market_estimates": [
              {
                "source": "google_shopping",
                "region": "NA",
                "A": 5190,
                "B": 4605,
                "C": 4290,
                "D": 3340
              }
            ],
            "historical_estimates": [
              {
                "region": "NA",
                "url": "https://trendful-data.s3.amazonaws.com/pricer/NA/handbags/louis-vuitton/historical.json"
              }
            ],
            "pricing_data": [
              {
                "region": "NA",
                "url": "https://trendful-data.s3.amazonaws.com/pricer/NA/handbags/louis-vuitton/pricing.json"
              }
            ],
            "popularity": 317,
            "images": [
              "https://trendful-api-images.s3.amazonaws.com/variant_Z4mQx8TnLpR2sV7cHk9YwE5aU1FbG6JdC3uN_800x800_0.jpg"
            ],
            "thumbnails": [
              "https://trendful-api-images.s3.amazonaws.com/variant_Z4mQx8TnLpR2sV7cHk9YwE5aU1FbG6JdC3uN_160x160_0.jpg"
            ]
          }
        ],
        "popularity": 85,
        "deleted": false,
        "nbWordsMatched": 3
      }
    }
  ],
  "processingTime": 3200,
  "predictionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Each result has a label, confidence score, matched id, and a product object containing attributes, variants (with market_estimates, historical_estimates, pricing_data), and metadata.

Credits

See Credits. Vision is always billed with taxonomy and pricing (10 credits).