search mobile facets autocomplete spellcheck crawler rankings weights synonyms analytics engage api customize documentation install setup technology content domains user history info home business cart chart contact email activate analyticsalt analytics autocomplete cart contact content crawling custom documentation domains email engage faceted history info install mobile person querybuilder search setup spellcheck synonyms weights engage_search_term engage_related_content engage_next_results engage_personalized_results engage_recent_results success add arrow-down arrow-left arrow-right arrow-up caret-down caret-left caret-right caret-up check close content conversions-small conversions details edit grid help small-info error live magento minus move photo pin plus preview refresh search settings small-home stat subtract text trash unpin wordpress x alert case_deflection advanced-permissions keyword-detection predictive-ai sso

Clickthrough

Track which results were clicked after a query.

This information will be collected and shown in the Analytics tab of your App Search dashboard.


POST /api/as/v1/engines/{ENGINE_NAME}/click
query
required
The query that the user searched with.
document_id
required
The id of the document that was clicked on.
request_id
optional
The request id returned in the meta tag of a search API response.
tags
optional
Array of strings representing additional information you wish to track with the clickthrough. You may submit up to 16 tags, and each may be up to 64 characters in length.
Example
curl -X POST 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/click' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer search-soaewu2ye6uc45dr8mcd54v8' \
-d '{
  "query": "everglade",
  "request_id": "e4c4dea0bd7ad3d2f676575ef16dc7d2",
  "document_id": "park_zion",
  "tags": ["firefox", "web browser"]
}'

Example
No Java example available, showing cURL
curl -X POST 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/click' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer search-soaewu2ye6uc45dr8mcd54v8' \
-d '{
  "query": "everglade",
  "request_id": "e4c4dea0bd7ad3d2f676575ef16dc7d2",
  "document_id": "park_zion",
  "tags": ["firefox", "web browser"]
}'

Example
No Node example available, showing cURL
curl -X POST 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/click' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer search-soaewu2ye6uc45dr8mcd54v8' \
-d '{
  "query": "everglade",
  "request_id": "e4c4dea0bd7ad3d2f676575ef16dc7d2",
  "document_id": "park_zion",
  "tags": ["firefox", "web browser"]
}'

Example
No Ruby example available, showing cURL
curl -X POST 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/click' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer search-soaewu2ye6uc45dr8mcd54v8' \
-d '{
  "query": "everglade",
  "request_id": "e4c4dea0bd7ad3d2f676575ef16dc7d2",
  "document_id": "park_zion",
  "tags": ["firefox", "web browser"]
}'

Example
No Python example available, showing cURL
curl -X POST 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/click' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer search-soaewu2ye6uc45dr8mcd54v8' \
-d '{
  "query": "everglade",
  "request_id": "e4c4dea0bd7ad3d2f676575ef16dc7d2",
  "document_id": "park_zion",
  "tags": ["firefox", "web browser"]
}'

Example
No Javascript example available, showing cURL
curl -X POST 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/click' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer search-soaewu2ye6uc45dr8mcd54v8' \
-d '{
  "query": "everglade",
  "request_id": "e4c4dea0bd7ad3d2f676575ef16dc7d2",
  "document_id": "park_zion",
  "tags": ["firefox", "web browser"]
}'

What's Next?

Clickthrough data is rich. Generate it from your applications for great insights into searcher behaviour. If you want to learn even more, the Analytics endpoint will provide a clear view into user search activity and document performance. If you want to start improving your results, consider reading about Synonyms and Curations.


Stuck? Looking for help? Contact support or check out the App Search community forum!