Agora Docs
HomeMerchantsDevelopers
  • Introduction
  • Customers
    • Overview
    • Guides
      • How to create an account
      • How to create a product list
      • How does Agora personalize your experience?
      • How to change the categories of products that appear on my Home page
      • How does Agora ensure products are authentic?
      • How to report a fake product
      • What is the Agora Product Score?
      • Who is Athena?
      • How to chat with Athena
      • Can I search for stores or brands on Agora?
      • How to cancel your order
      • When can I get a refund?
      • What are Agora Credits?
      • How to use Agora Credits
      • What are Sponsored products?
      • Supported countries for Add To Cart
      • What are Popular Products?
      • What is the camera icon on the search bar?
      • What is Image Search?
      • How to search by location
      • How to search by URL
      • What are Product Pros and Cons?
      • Dark mode on Agora
      • Agora out of stock policy
      • How to return a product
      • Agora refund and return policy
      • Delivery Guarantee
      • Privacy
      • Secure payments
    • Compliance
  • Merchants
    • Overview
    • Guides
      • Home page docs
      • Products page docs
      • Subscription page docs
      • Tools page docs
      • Team page docs
      • Settings page docs
      • How to create a merchant account
      • How to upload products
      • How to check if your store is on Agora
      • How is click-through rate defined on Agora?
      • What are product opens on Agora?
      • How to upload your products from Squarespace
      • How to retrieve your Squarespace API Key
      • How to upload your products from Wix
      • How to retrieve your Wix API Key
      • How to track your store performance
      • How to track product-specific performance
      • How to track product reviews
      • How to edit product names and descriptions
      • How to add keywords to your products
      • How to select a Subscription plan
      • Why upgrade to a Subscription plan
      • How is Agora different from Google advertising?
      • How to upgrade my Subscription plan
      • How to downgrade my Subscription plan
      • How to cancel my Subscription
      • How to delete my merchant account
      • How to add a payment method
      • When do I get billed?
      • What is a Verified Product?
      • How to Verify a product
      • What is a Boosted Product?
      • How to Boost a product
      • How long will a product be Boosted for?
      • How to delete a product
      • How to change my profile information
      • How to customize my storefront on Agora
      • How to invite team members
      • How to submit feedback
      • How to download an invoice
      • What is an Enterprise plan?
      • What is the cost of an Enterprise plan?
      • How do I improve my Agora Product's Scores?
      • How to update your store on Agora
      • How to track your Orders on Agora
      • How to track your customers on Agora
      • How to track your abandoned carts on Agora
      • How to buy an annual Subscription
      • How to integrate Agora with other tools
      • How to re-order your products on your Agora store page
    • Fake Products Policy
    • Dropshipping policy
    • Reseller policy
    • Low-Quality Products Policy
    • User Protection Policy
    • Compliance
    • Shipping
  • API
    • Get started
    • Test the API
    • Authentication
    • Payment encryption
    • Rate limiting
    • Endpoints
      • Base URL
      • Text search trial
      • Refresh token
      • Text search
      • URL search
      • Image search
      • Detect objects
      • Location search
      • Store search
      • Brand search
      • Product detail
      • Get products by store
      • Get products by brand
      • Create cart
      • Add to cart
      • Get a cart
      • Create an order
      • Track an order
  • Support
Powered by GitBook
On this page

Was this helpful?

  1. API
  2. Endpoints

Image search

Image search is a 2 step process. First, you send the image as a base64 encoded string to receive a slug id of the vectorized image. Second, you use that id to get search results of similar products.

PreviousURL searchNextDetect objects

Last updated 1 day ago

Was this helpful?

Step 1: POST /vectorize-image

This endpoint lets you to create a vectorization id for an image by providing a base64 encoded string of the image.

Note: If you want to detect specific objects in an image before starting the image search process, you want to use the endpoint.

Headers

Header
Type
Description

Authorization

string

Bearer token

Request body

The request passes the base64 encoded string of the image you want to use.

{
    "base64String": "string"
}

Response

{
  "status": "success",
  "slug": "newRequest.slug"
}
{
 "status": "error",
 "message": "Internal Server Error"
}

Step 2: GET /search

This endpoint lets you to search products that match the image.

Headers

Header
Type
Description

Authorization

string

Bearer token

Query parameters

Parameter
Type
Description

imageId

string

Image search identifier.

Response

{
  "status": "success",
  "Products": [
        {
            "_id": "65d4d4f1b7bb634c6599ffd2",
            "name": "Calzuro Classic Without Holes Pistachio",
            "brand": "Calzuro",
            "storeName": "Calzuro",
            "slug": "calzuro-without-pistachio-eb12f468-48a2-48af-9f5e-3fda5f6c135c-1708446961787",
            "price": 111.99,
            "isVerified": true,
            "isBoosted": false,
            "images": [
                "https://cdn.shopify.com/s/files/1/0738/4442/4986/products/pistachio-calzuro-without-1.jpg?v=1682709875",
                "https://cdn.shopify.com/s/files/1/0738/4442/4986/files/pistachiocalzuro.png?v=1712343485",
                "https://cdn.shopify.com/s/files/1/0738/4442/4986/files/classicinfographic_26486960-c007-4661-b74d-b50e158115cc.png?v=1712343485",
                "https://cdn.shopify.com/s/files/1/0738/4442/4986/products/pistachio-calzuro-without-2.jpg?v=1712343483",
                "https://cdn.shopify.com/s/files/1/0738/4442/4986/products/pistachio-calzuro-without-3.jpg?v=1712343483",
                "https://cdn.shopify.com/s/files/1/0738/4442/4986/products/pistachio-calzuro-without-4.jpg?v=1712343483"
            ],
            "url": "https://calzuro.com/products/calzuro-without-pistachio",
            "agoraScore": 95,
            "priceHistory": [
                {
                    "price": 111.99,
                    "date": "2024-02-20T16:36:01.992Z",
                    "_id": "671499c36ca0a1804aca445f"
                }
            ],
            "discountVal": 0,
            "averageRating": 4.5
        }
    ]
}
{
 "status": "error",
 "message": "Internal Server Error"
}
/detect-objects