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

Text search trial

GET /search/trial

This endpoint provides a trial version of the product search feature. You can search for products with fewer parameters.

Headers

No headers required.

Query parameters

Parameter
Type
Description

q

string

Search query.

priceRange

array

Price range filter [minPrice, maxPrice].

sort

string

Sorting field: price:relevance.

order

string

Sorting order: asc or desc.

Example request

GET https://zues.searchagora.com/api/v1/search/trial?q=query&priceRange=[100,1000]&sort=price:relevance&order=desc

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"
}
PreviousBase URLNextRefresh token

Last updated 3 months ago

Was this helpful?