This document provides examples of queries and calls that may be useful for frontend development of your application.

​
Prerequisites

Before working with the Managed Fusion API, ensure that you have specified API permissions or roles to allow access to the API.

​
Simple queries

​
Send signals to Managed Fusion from frontend applications

The Signals API stores signals as JSON for indexing into a signals collection. See Signals API for more information. REQUEST 
https://EXAMPLE_COMPANY.lucidworks.cloud/api/signals/COLLECTION_NAME
Replace EXAMPLE_COMPANY with the name provided by your Lucidworks representative.
ENDPOINTS
POST
/signals/COLLECTION_NAMESend one or more signals for indexing
PARAMETERS
commitoptionalThe commit parameter can potentially cause resource problems if your application has a high signal volume, or if it sends all signals as individual POST requests in real-time.
collectionrequiredCollection ID
paramsoptionalConfiguration parameters For more information, see Parallel Bulk Loader.
EXAMPLE 
curl \
 -u USERNAME:PASSWORD -X POST -H 'Content-type:application/json' -d @- \
https://EXAMPLE_COMPANY.lucidworks.cloud/api/signals/docs?commit=true \
<<EOF
[{
    "params": {
      "query": "Televisiones Panasonic  50 pulgadas",
      "filterQueries": ["cat00000", "abcat0100000", "abcat0101000", "abcat0101001"],
      "docId": "2125233"
    },
    "type": "click",
    "timestamp": "2011-09-01T23:44:52.53Z"
  },
  {
    "params": {
      "query": "Sharp",
      "filterQueries": ["cat00000", "abcat0100000", "abcat0101000", "abcat0101001"],
      "docId": "2009324"
    },
    "type": "click",
    "timestamp": "2011-09-05T12:25:37.42Z"
  }
]
EOF

​
Send queries to Managed Fusion using the Query Profile

REQUEST 
https://EXAMPLE_COMPANY.lucidworks.cloud/api/apps/APP_NAME/query/QUERY_PROFILE?QUERY
ENDPOINTS
POST
/signals/COLLECTION_NAMESend one or more signals for indexing
PARAMETERS
rowsoptionalThe number of documents (results) to return
wtrequiredThe response format. For example, XML, JSON, CSV
floptionalThe list of fields to return for each document in the response
EXAMPLE 
https://EXAMPLE_COMPANY.lucidworks.cloud/api/apps/Movies/query/Movies_main?q=star&fq=genres_ss:(“Sci-Fi”)&rows=5

​
Complex queries

​
Call the query profiles assigned to a zone

The Render API is part of the Templating API. It is the main way to ingest the content of templates and their contained zones, which will further drive the search experience. Templates/zones data cannot be incorporated with the Query Profile or Query Pipelines APIs. You can create templates in the Managed Fusion UI, specifying trigger criteria for each template, such as search terms or filters. You can then add zones to these templates, choosing a query profile to be queried for each zone along with other configurable data. When you query the Render API, Managed Fusion determines which template’s trigger criteria is satisfied by the query and calls the query profiles designated by the zones in the triggered template, passing the original query on to each query profile. The results from each query profile are returned alongside the zone configuration in the final response. For example, a web frontend can consume this API to drive a search results page. It will inspect the list of returned zones, using each zone’s configuration to decide how to display each query profile result in the UI. This allows you to manage the search experience with the Managed Fusion UI, using the template trigger criteria and zone configuration along with different query profiles to define what content should be shown based on the search context. Templates and zones have both a “staging” and “live” (or “published”) version. The staging parameter present on all Render API endpoints determines the version of the content that will be used. Modifications to the templating content only show in the “staging” view until you publish the content. The Render API works similarly to the Query API in that it supports all of the same ways of providing a query, and the responses for each zone are the same structure. However, there are four differences:
  • You do not need to specify a query profile in your request
  • The endpoint paths are different
  • The Render API determines which template to trigger based on the query terms, filters, and the templates’ configurations
  • The provided query is issued against one or more query profiles (one for each zone in the triggered template), and the response from each query profile is included in the Render API response.
See Query Profile API for more information. REQUEST 
https://EXAMPLE_COMPANY.lucidworks.cloud/api/templating/render/APP_NAME
See Templating API for more supported parameters.
ENDPOINTS
GET
/render/APP_NAMERetrieve and render the template for the given navigation state. By default will only trigger published versions of templates, specify staging=true to instead trigger staging versions of templates.
/renderId/TEMPLATE_IDRetrieve and render the template with the specified id. All provided query params will be passed on to each query profile invoked during the rendering.
POST
/render/APP_NAMERetrieve and render the template for the given navigation state. By default will only trigger published versions of templates, specify staging=true to instead trigger staging versions of templates.
/renderDSL/APP_NAMERetrieve and render the template for the given navigation state. By default will only trigger published versions of templates, specify staging=true to instead trigger staging versions of templates. The provided DSL request object + any additional request parameters are passed through to each query profile when rendering each zone.
/renderId/TEMPLATE_IDRetrieve and render the template with the specified id. All provided query params will be passed on to each query profile invoked during rendering.
/renderIdDSL/TEMPLATE_IDRetrieve and render the template with the specified id, passing the provided DSL request to each query profile invoked during rendering.
EXAMPLE The example query specifies some query as the query terms and is restricted to only return templates of the landing type. It will retrieve the template with trigger criteria that is satisfied by the query terms some query. By specifying staging=true, it will only consider the current “staging” version of the templating content, which are templates/zones that haven’t been published yet. Omitting the staging param would return only the published versions of templates/zones. 
GET https://EXAMPLE_COMPANY.lucidworks.cloud/api/templating/render/APP_NAME?q=QUERY&templateTypes=landing&staging=true

​
Queries for recommendations

​
Create a personalized list of potential interests

The Recommendations API uses signals to generate a personalized list of interests. See Recommendations API for more information. REQUEST 
https://EXAMPLE_COMPANY.lucidworks.cloud/api/recommend/APP_NAME/{endpoint}?q=QUERY
ENDPOINTS
GET
itemsForQueryGet items for a defined query. The response is a list of document IDs and their weights.
queriesForItemGet queries for a defined item (a document ID). This finds the top queries that led users to the defined item. The response is a list of query terms and their weights.
EXAMPLES 
curl -u USERNAME:PASSWORD https://EXAMPLE_COMPANY.lucidworks.cloud/api/recommend/lucidworks102/itemsForQuery?q=ipod&fq=count_d:4&debug=true

curl -u USERNAME:PASSWORD https://EXAMPLE_COMPANY.lucidworks.cloud/api/recommend/lucidworks102/queriesForItem?docId=9225439`