Skip to main content
import requests

headers = {
  "Content-Type": "application/json",
  "x-api-key": "YOUR_ADGENTIC_API_KEY"
}

payload = {
  "prompt": "I want to buy a smartwatch",
  "context": {
      "country": "US"
  }
}

response = requests.post("https://adgentic-gateway-api-869728233318.us-central1.run.app/api/v1/query", json=payload, headers=headers)
print(response.json())

import requests

headers = {
  "Content-Type": "application/json",
  "x-api-key": "YOUR_ADGENTIC_API_KEY"
}

payload = {
  "prompt": "I want to buy a smartwatch",
  "context": {
      "country": "US"
  }
}

response = requests.post("https://adgentic-gateway-api-869728233318.us-central1.run.app/api/v1/query", json=payload, headers=headers)
print(response.json())
Endpoint: POST /api/v1/query

​
Query Parameters:

​
prompt
string
required
The user’s search or request.
​
country
string
Country code for localized results.

​
Enriched Product Attributes

CategoryFieldTypeDescription
product_identityproduct_titlestringName of the product (enriched).
product_descriptionstringText description explaining the product (enriched).
product_linkstring (URL)Tracking link to the product detail page.
product_image_linkstring (URL)URL of the main product image.
currencystringCurrency code (ISO 4217, e.g., USD, EUR).
pricenumericCurrent product price.
availabilitystringStock status (e.g., “In Stock”, “Out of Stock”, “Preorder”).
brandstringManufacturer or seller’s brand name.
physical_characteristics—stringTangible, visible product attributes (e.g., color, size, weight, material).
technical_specs—stringHardware, electronic or digital specifications (e.g., battery life, connectivity, power rating).
functional_features—stringUsability-related attributes (e.g., water resistance, modes of operation, safety features).
compatibility—stringContexts and supported systems (e.g., device compatibility, universal fit, target audience).
performance_metrics—numericQuantifiable product performance (e.g., speed, noise level, battery duration, comfort rating).
content_and_packaging—stringPackaging details and included items (e.g., box contents, setup instructions, packaging material).
warrant_and_certification—stringLegal and quality guarantees (e.g., warranty period, return policies, certifications).
sustainability—stringEco-friendly and repairability attributes (e.g., recyclability, energy efficiency, eco-labels).
review_metrics—stringUser feedback data (e.g., ratings, number of reviews).
agentic_tagsideal_use_casestringMain intended usage scenario or best settings where product shines.
persona_fitstringFit to a particular user persona (types of people who benefit most).
lifestyle_alignmentstringLifestyle or value context the product aligns with.
advertiser_infoadvertiser_namestringName of the advertiser/seller.
advertiser_websitestring (URL)Official advertiser website.
advertiser_logostring (URL)URL of advertiser’s logo image.
advertiser_categorystringIndustry or category (e.g., Footwear, Electronics).
monetization_infocommission_ratenumericCommission percentage per sale.
referral_periodstringReferral cookie window (e.g., “30 days”).
Was this page helpful?👍 Yes👎 No