Agentic Search Mini

Fast unbounded product discovery with AI-powered attribute enrichment. Get up to 10 products with detailed attributes in milliseconds.

POST https://api.getcatalog.ai/v1/agentic-search-mini

cURL

curl -X POST https://api.getcatalog.ai/v1/agentic-search-mini \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "query": "sustainable midi dresses",
    "enable_enrichment": true
  }'

Success Response

{
  "products": [
    {
      "url": "https://eco-fashion.com/sustainable-midi-dress-olive",
      "title": "Organic Cotton Midi Dress in Olive",
      "price_amount": 128.00,
      "price_currency": "USD",
      "description": "Effortlessly elegant midi dress crafted from GOTS-certified organic cotton with a flattering A-line silhouette.",
      "images": [
        "https://eco-fashion.com/images/midi-dress-olive-front.jpg",
        "https://eco-fashion.com/images/midi-dress-olive-detail.jpg"
      ],
      "attributes": {
        "color": "olive green",
        "material": "100% organic cotton",
        "category": "Women > Dresses > Midi",
        "brand": "Terra Collective",
        "features": "GOTS certified, V-neck, 3/4 sleeves, side pockets",
        "size_range": "XS-XL",
        "care": "Machine wash cold, hang dry"
      }
    },
    {
      "url": "https://conscious-style.com/tencel-wrap-dress",
      "title": "TENCEL™ Wrap Midi Dress",
      "price_amount": 145.00,
      "price_currency": "USD",
      "description": "Luxuriously soft wrap dress made from sustainable TENCEL™ lyocell with an adjustable tie waist.",
      "images": [
        "https://conscious-style.com/images/tencel-wrap-dress.jpg"
      ],
      "attributes": {
        "color": "forest green",
        "material": "TENCEL™ lyocell",
        "category": "Women > Dresses > Wrap",
        "brand": "Mindful",
        "features": "Wrap style, tie waist, midi length, sustainable fiber",
        "size_range": "XS-XXL",
        "sustainability": "Biodegradable, responsibly sourced"
      }
    }
  ],
  "meta": {
    "totalItems": 2,
    "urls": [
      "https://eco-fashion.com/sustainable-midi-dress-olive",
      "https://conscious-style.com/tencel-wrap-dress"
    ]
  }
}

The Agentic Search Mini endpoint provides fast, intelligent product discovery enhanced with AI-powered attribute analysis. This lightweight endpoint is optimized for speed while still providing detailed product attributes through optional AI enrichment.

When to use Agentic Search Mini

Use this endpoint when you need:

• Fast product discovery with sub-second response times
• Limited result set of up to 10 high-quality products
• AI-powered attribute enrichment for detailed product analysis

For larger result sets or more comprehensive search capabilities, consider using the full Agentic Search endpoint instead.

How to authenticate requests

x-api-key · string · required

Your API key for authentication. Get your API key if you don’t have one yet.

What parameters can you send?

query · string · required

Natural language search query for product discovery

Examples:

• "sustainable midi dresses"
• "luxury minimalist handbags"
• "versatile blazers for work"

enable_enrichment · boolean · default: "true"

Enable AI-powered product attribute enrichment for enhanced product data analysis. Set to false for faster response times if detailed attributes are not needed.

When to disable enrichment:

• You need the fastest possible response times
• You only need basic product information (title, price, URL)
• You’re building a real-time autocomplete feature

When to enable enrichment (default):

• You need detailed product attributes (color, material, features)
• You’re building product comparison tools
• You need rich product data for AI-powered recommendations

What does the API response include?

The API returns up to 10 products with detailed information and optional AI-enriched attributes. Each response includes both product data and metadata about the search results.

products · array

Array of discovered products with enriched data (limited to 10 results for optimal performance)

Show Product Properties

url · string

Product URL (normalized and cleaned)

title · string

Product title

price_amount · number

Product price as a number (e.g., 99.99)

price_currency · string

Currency code (e.g., “USD”)

description · string

Product description

images · array

Array of product image URLs

attributes · object

Comprehensive product attributes extracted through AI analysis

Show Common Attributes

color · string

Primary product color

material · string

Primary material composition

category · string

Product category classification

brand · string

Brand information

features · string

Key product features

meta · object

Search result metadata

Show Meta Properties

totalItems · number

Total number of products found

urls · array

Array of all product URLs returned

How does this compare to other search endpoints?

Feature	Agentic Search Mini	Regular Search	Full Agentic Search
Response Time	< 1 second	< 500ms	1-3 seconds
Max Results	10 products	50+ products	50+ products
AI Enrichment	✅ Optional	❌ No	✅ Advanced
Best For	Fast discovery	High-volume searches	Comprehensive analysis

Example implementation

cURL

curl -X POST https://api.getcatalog.ai/v1/agentic-search-mini \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "query": "sustainable midi dresses",
    "enable_enrichment": true
  }'

Success Response

{
  "products": [
    {
      "url": "https://eco-fashion.com/sustainable-midi-dress-olive",
      "title": "Organic Cotton Midi Dress in Olive",
      "price_amount": 128.00,
      "price_currency": "USD",
      "description": "Effortlessly elegant midi dress crafted from GOTS-certified organic cotton with a flattering A-line silhouette.",
      "images": [
        "https://eco-fashion.com/images/midi-dress-olive-front.jpg",
        "https://eco-fashion.com/images/midi-dress-olive-detail.jpg"
      ],
      "attributes": {
        "color": "olive green",
        "material": "100% organic cotton",
        "category": "Women > Dresses > Midi",
        "brand": "Terra Collective",
        "features": "GOTS certified, V-neck, 3/4 sleeves, side pockets",
        "size_range": "XS-XL",
        "care": "Machine wash cold, hang dry"
      }
    },
    {
      "url": "https://conscious-style.com/tencel-wrap-dress",
      "title": "TENCEL™ Wrap Midi Dress",
      "price_amount": 145.00,
      "price_currency": "USD",
      "description": "Luxuriously soft wrap dress made from sustainable TENCEL™ lyocell with an adjustable tie waist.",
      "images": [
        "https://conscious-style.com/images/tencel-wrap-dress.jpg"
      ],
      "attributes": {
        "color": "forest green",
        "material": "TENCEL™ lyocell",
        "category": "Women > Dresses > Wrap",
        "brand": "Mindful",
        "features": "Wrap style, tie waist, midi length, sustainable fiber",
        "size_range": "XS-XXL",
        "sustainability": "Biodegradable, responsibly sourced"
      }
    }
  ],
  "meta": {
    "totalItems": 2,
    "urls": [
      "https://eco-fashion.com/sustainable-midi-dress-olive",
      "https://conscious-style.com/tencel-wrap-dress"
    ]
  }
}