Create deep links - Fluid Topics - Latest

Fluid Topics API Reference Guide

Category
Reference Guides
Audience
public
Version
Latest

It is possible to use both built-in and custom metadata to create a deep link. The following built-in metadata keys are common candidates for building deep links:

  • ft:publication_title - the title of the publication.
  • ft:sourceId - the id parameter of the source used to upload the content.
  • ft:sourceName - the name parameter of the source used to upload the content.
  • ft:sourceType - the type parameter of the source used to upload the content.
  • ft:lastPublication - the date of the last publication. It takes the following format: YYYY-MM-DD.

A deep link can contain multiple occurrences of a metadata key.

It is possible to use the List maps API to retrieve all relevant metadata.

  • Do not use quotes around metadata values when creating a deep link.
  • It is necessary to correctly encode deep links. For more information, see URL encoding.
  • A deep link that targets a non-existent metadata key points to one of the first results displayed when submitting an empty search query. For this reason, it is important to always use an existing metadata key.

The template to build a deep link pointing to a map is as follows:

https://myfluidtopics.com/access/sources/{sourceId}/map?$METADATA=$METADATA_VALUE&...

The template to build a deep link pointing to a topic is as follows:

https://myfluidtopics.com/access/sources/{sourceId}/topic?$METADATA=$METADATA_VALUE&...