API Reference

Header

X-API-Key: your_api_key_here

{
  "query": "enterprise CRM for sales teams",
  "explain": true  // optional, returns AI explanations
}

{
  "results": [
    {
      "id": 1,
      "name": "ProCRM Enterprise",
      "category": "software",
      "brand": "AcmeSoft",
      "description": "...",
      "attributes": { ... }
    }
  ],
  "explanations": [
    {
      "product_id": 1,
      "reason": "Matches enterprise CRM for sales..."
    }
  ],
  "parsed_query": {
    "filters": { "category": "software" },
    "semantic_search_query": "enterprise CRM sales teams"
  }
}

curl -X POST https://api.understnd.dev/v1/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{"query": "enterprise CRM for sales teams"}'

{
  "items": [
    {
      "name": "ProCRM Enterprise",
      "category": "software",
      "brand": "AcmeSoft",
      "description": "CRM for B2B sales teams"
    }
  ]
}

import requests

response = requests.post(
    "https://api.understnd.dev/v1/ingest/batch",
    headers={"X-API-Key": "your_api_key"},
    json={"items": products}
)

print(f"Imported {len(response.json()['products'])} items")

import { UnderstndClient } from '@understnd/sdk';

const client = new UnderstndClient({
  apiKey: 'your_api_key'
});

const results = await client.search('enterprise CRM');
console.log(results);

from understnd import UnderstndClient

client = UnderstndClient(
    base_url="https://api.understnd.dev",
    api_key="your_api_key"
)

results = client.search("enterprise CRM")
print(results)