API reference
These pages are the authoritative VizSeek API reference. They call out the legacy request formats, URL-encoding rules, auth requirements, and response quirks that are easy to miss if you only look at controller signatures.
Start here
Section titled “Start here”- Authentication
- Token endpoint
- Search
- Files
- File metadata
- Saved searches
- Accounts and company
- RFQ
- Utilities
- Integration examples
Legacy behavior to keep in mind
Section titled “Legacy behavior to keep in mind”- Many request bodies are not JSON objects or JSON arrays. They are JSON strings whose contents are base64 data or even a JSON array encoded as a string.
filterStris a nested query string. URL-encode the wholefilterStrvalue. If theFT=value itself contains=or&, encode the innerFTvalue first, then encode the wholefilterStr.- Search responses may return
/api/ImageURLs that include a short-livedtokenquery parameter. Thattokenis not your bearer token. Send it back exactly as returned. - Several older XML comments are stale. These docs follow the current controller behavior where they differ.
- The API also contains internal endpoints (sync-app, bulk-ingest, admin, RAG, RFQ-line, and similar) that are intentionally excluded from this reference and are not part of the supported customer contract, even though their routes may resolve.
- The
POST /api/Tokenendpoint is served by the OAuth middleware, not a REST controller.