The site's search: the smart search index built from its content with embeddings, and the AI answer from it.
Endpoints that need a token: the site owner creates it in their admin (Developers > API reference). AI assistants: how to ask the user for one.
5 endpoints.
Meaning-based search over the site's content, for the search component. Reads no token. Answers the matching items for the search component.
Public - no token needed.
The smart search's kinds.
The words to search for.
The smart search's price.
The smart search's dates.
The smart search's collections.
The smart search's items.
The order of the results.
How many results to skip - for paging.
How many results to return.
curl -X POST 'http://smartman.max-media.io/smart-search?ionic=true' \
-H 'Content-Type: application/json' \
-d '{ "kinds": "...", "q": "...", "price": "...", "dates": "...", "collections": "..." }'An overview answer to the visitor's question, written only from the site's content the search finds. Reads no token. Answers { answer, sources }; empty when nothing relevant is found, and 429 past a visitor's hourly limit.
Public - no token needed.
The words to search for.
The smart search's kinds.
The smart search's price.
The smart search's dates.
The smart search's collections.
The smart search's items.
curl -X POST 'http://smartman.max-media.io/smart-search/answer?ionic=true' \
-H 'Content-Type: application/json' \
-d '{ "q": "...", "kinds": "...", "price": "...", "dates": "...", "collections": "..." }'The site's searchable items, for the editor's "only these items" picker. ?kinds and ?q narrow the list.
Needs a site admin token.
Only smart searches with this kinds.
The words to search for.
curl -X GET 'http://smartman.max-media.io/smart-search/items?ionic=true&kinds=...&q=...' \ -H 'Authorization: Bearer <TOKEN>'
Fills the site's locales with the search component's words in the site's language - the editor calls it when the component is added. Answers { added }: the keys that were missing.
Needs a site admin token.
curl -X POST 'http://smartman.max-media.io/smart-search/locales?ionic=true' \ -H 'Authorization: Bearer <TOKEN>'
Teach the search: index the site's content now (the editor's button). Only content that changed is embedded again. Answers what was indexed.
Needs a site admin token.
The smart search's rebuild.
curl -X POST 'http://smartman.max-media.io/smart-search/reindex?ionic=true' \
-H 'Authorization: Bearer <TOKEN>' \
-H 'Content-Type: application/json' \
-d '{ "rebuild": "..." }'