Skip to main content
POST
https://api.evergreens.ai
/
v1
/
networks
/
browser
/
shopping-search
  {
    "query": "iphone 17 kaufen in Innsburck",
    "countryCode": "at",
    "languageCode": "de",
    "maxResults": 5
  }

{
  "status": true,
  "data": {
    "isCached": false,
    "cacheExpiresIn": null,
    "results": [
      {
        "title": "Apple iPhone 17Apple iPhone 17",
        "link": "https://www.google.com/search?ibp=oshop&q=Apple+iPhone+17Apple+iPhone+17&prds=catalogid%3A13867575581120009415%2Cgpcid%3A6027158597472037202%2CimageDocid%3A9704594717021643381%2Cmid%3A576462866558881327%2Cpvo%3A3%2Cpvt%3Ahg%2Crds%3APC_6027158597472037202%7CPROD_PC_6027158597472037202&pvorigin=25&hl=de&gl=at&udm=28&shndl=37&shem=pvflt%2Cshrtsdl&source=sh%2Fx%2Fprdct%2Fhdr%2Fm1%2F1&utm_source=pvflt%2Cshrtsdl%2Csh%2Fx%2Fprdct%2Fhdr%2Fm1%2F1",
        "price": "€ 949,00",
        "oldPrice": null,
        "shop": "Apple",
        "distance": null,
        "totalReviews": 1855,
        "position": null
      },
      // more results...
    ]
  }
}
Entity Reference:
ShoppingSearchEntity child of SearchEntity
Example

​
Request

​
query
string
required
The search query string to be used for retrieving web search results.Restrictions:
RoleDescription
Max characters100 characters
Min characters1 character
​
maxResults
number
default:5
The maximum number of search results to return.Restrictions:
RoleDescription
Min value1
Max value10
​
countryCode
string
default:"at"
The ISO 3166-1 alpha-2 country code to tailor search results to a specific country.
​
languageCode
string
default:"de"
The ISO 639-1 language code to specify the language of the search results.
​
fields
enum
default:["title","link","price","position"]
An array specifying which fields to include in the shopping search results. Possible values are:
  • 'title': The title of the product.
  • 'link': The URL link to the product page.
  • 'price': The current price of the product.
  • 'oldPrice': The old price of the product (if available).
  • 'shop': The name of the shop or seller.
  • 'distance': The distance to the shop (if applicable).
  • 'totalReviews': The total number of reviews for the product.
  • 'position': The position of the product in the search results.
​
cache
object
An optional object to configure caching behavior for the request. By default, caching is enabled with a TTL of 120 seconds. You can customize these settings by providing the cache object.

​
Response

​
isCached
boolean
default:true
Indicates whether the response was served from cache.
​
cacheExpiresIn
number
default:7200
The time in seconds until the cached response expires. Default is 7200 seconds (2 hours).
​
results
ShoppingSearchEntity[]
required
An array of shopping search result entities matching the search query.
  {
    "query": "iphone 17 kaufen in Innsburck",
    "countryCode": "at",
    "languageCode": "de",
    "maxResults": 5
  }

{
  "status": true,
  "data": {
    "isCached": false,
    "cacheExpiresIn": null,
    "results": [
      {
        "title": "Apple iPhone 17Apple iPhone 17",
        "link": "https://www.google.com/search?ibp=oshop&q=Apple+iPhone+17Apple+iPhone+17&prds=catalogid%3A13867575581120009415%2Cgpcid%3A6027158597472037202%2CimageDocid%3A9704594717021643381%2Cmid%3A576462866558881327%2Cpvo%3A3%2Cpvt%3Ahg%2Crds%3APC_6027158597472037202%7CPROD_PC_6027158597472037202&pvorigin=25&hl=de&gl=at&udm=28&shndl=37&shem=pvflt%2Cshrtsdl&source=sh%2Fx%2Fprdct%2Fhdr%2Fm1%2F1&utm_source=pvflt%2Cshrtsdl%2Csh%2Fx%2Fprdct%2Fhdr%2Fm1%2F1",
        "price": "€ 949,00",
        "oldPrice": null,
        "shop": "Apple",
        "distance": null,
        "totalReviews": 1855,
        "position": null
      },
      // more results...
    ]
  }
}