Skip to main content

Fluid Topics API

Project description

Python Fluid Topics API

The Python Fluid Topics API is an integrator kit for developing Fluid Topics connectors.


We recommend using to install the Fluid Topics API for Python.

$ pip install fluidtopics

Getting started

We will see how to publish to Fluid Topics. To do this, you should have a Fluid Topics user with KHUB_ADMIN right.

1. Create external source

To use this api, a Fluid Topics external source should be created. It is possible to do it manually, or programmatically:

from fluidtopics.connector import LoginAuthentication, RemoteClient

# First, create a RemoteClient
auth = LoginAuthentication('', 'user_password')
client = RemoteClient('', auth, 'external_source_id')

# Then create the source

2. Publish document

When the RemoteClient and the external source are created, it is possible to publish in Fluid Topics.

Structured document

from fluidtopics.connector import StructuredDocument, Topic

topic = Topic.create(
    title='First step',
    body='<p>First, read this tutorial</p>'
document = StructuredDocument.create(
    title='How to use fluidtopics python API',


Unstructured document

from fluidtopics.connector import UnstructuredDocument

document = UnstructuredDocument.from_uri(


uri parameter can be a file path, or an url.

External document

from fluidtopics.connector import ExternalDocument

document = ExternalDocument.create(
    title='Fluid Topics python API on',


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

fluidtopics-1.0.3-py3-none-any.whl (70.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page