DealerAI
API Reference

Translate Search Query

Converts a natural language car search query into a structured logic expression using OpenAI. Returns filter criteria that can be used for precise inventory searches.

POST
/api/v1/search/translate

Authorization

basic
AuthorizationBasic <token>

Basic Authorization header

In: header

Request Body

application/json

The search request containing the natural language query to translate into structured filters.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://api.dealerai.com/api/v1/search/translate" \  -H "Content-Type: application/json" \  -d '{}'
{
  "comparator": "string",
  "attribute": "string",
  "value": null,
  "operator": "string",
  "arguments": [
    {
      "comparator": "string",
      "attribute": "string",
      "value": null,
      "operator": "string",
      "arguments": []
    }
  ]
}
{
  "message": "string",
  "details": null
}
{
  "message": "string",
  "details": null
}
{
  "message": "string",
  "details": null
}

Upload New Inventory JSON

Uploads a JSON file containing new car inventory data and replaces all existing inventory for the dealership.

Search Cars

Searches both new and used car inventory using natural language queries. Translates the query into structured filters and returns matching vehicles from the dealership's inventory.