Neuroon API

The Neuroon REST API allows you to integrate semantic search into any application.

Base URL

https://api.neuroon.ai/api

Authentication

All requests require token authentication:

curl -X GET https://api.neuroon.ai/api/search \
  -H "X-Widget-Token: YOUR_TOKEN"

See Authentication for more details.

Response format

All responses are JSON:

{
  "data": { ... },
  "meta": {
    "queryTimeMs": 45
  }
}

Errors

{
  "error": {
    "code": "INVALID_TOKEN",
    "message": "Invalid or expired token"
  }
}

Status codes

Code	Description
200	Success
400	Invalid request
401	Not authenticated
403	Not authorized
404	Not found
429	Rate limit exceeded
500	Server error

Main endpoints

Endpoint	Method	Description
/search	POST	Semantic search
/suggestions	GET	Autocomplete
/products	GET	List products
/products/sync	POST	Sync products

SDKs

• JavaScript: @neuroon/widget (includes API client)
• PHP: Coming soon
• Python: Coming soon

Limits

See Rate Limits for usage limit information.