The Instant Search Connector is an endpoint in our API that allows you to quickly connect external apps, like content management, marketing automation, and customer relationship management systems, and e-commerce tools, to the Widen Collective to search for assets in those apps using the same user interface (UI) that's in the Collective. This functionality reduces the time needed from outside developers to connect assets to other common tools.


You must authenticate through the API to use the Instant Search Connector. After authentication, the UI that's presented allows you to search for assets, see thumbnail previews, select share links and embed codes for use, and view, share, and download assets. Assets that display are based on the permissions of the user the API key is linked to.


The connector has the flexibility to enable or disable the display of the search bar. More information is available in our API search connector documentation. Alternatively, the List by Search Query API call can be used by your development team to create a search experience that's fully customized to your needs.



Supported searches

Searching in the connector is the same as using the quick search in the Collective. The supported search types in the connector are:

  • Category search
  • Document text search
  • Does not contain search
  • Exact search
  • Field-specific search
  • File format search
  • Filename search
  • Last edit date/last history date search
  • Metadata field search
  • Metadata type search
  • Phrase search
  • Wildcard search


The quick search article provides information about sample searches, complex quick searches, search results, and international characters, which also apply in the connector.


Searching within and filtering searches are not supported in the connector.