datalumo

Documentation

Getting Started

Getting Started

Datalumo lets you upload your own content, search it by meaning, and embed AI-powered answers on your site. No machine learning setup required.

Create an account

Sign up at Datalumo to create your account. After registering you'll be taken to your dashboard where you can manage collections, entries, and integrations.

Collections

A collection is a container for related content. For example, you might create a "Support Articles" collection, a "Product FAQs" collection, or a "Knowledge Base" collection.

You can create collections from the dashboard or via the API.

Adding entries

Entries are the individual pieces of content inside a collection. Each entry has a title, text content, optional metadata, and source information.

File upload

From the dashboard, you can upload files to populate a collection. Supported formats:

  • CSV — each row becomes an entry
  • Excel (.xlsx) — each row becomes an entry
  • PDF — text is extracted and chunked automatically
  • JSON — array of objects, each becomes an entry
  • XML — elements are parsed into entries

When importing tabular data (CSV, Excel), you'll be asked to map columns to entry fields (title, text, meta, etc.).

Via the API

Push entries programmatically using the API. This is useful for syncing content from a CMS, database, or other system.

curl -X POST https://datalumo.app/api/v1/collections/{collection}/entries \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Refund policy",
    "raw_text": "Refunds are available for 30 days after purchase...",
    "meta": {"category": "policy", "tags": ["billing", "refunds"]},
    "source_type": "web",
    "source_id": "refund-policy-v2"
  }'

For bulk syncing, use the upsert or batch upsert endpoints to create or update entries by their source_type and source_id.

See the API Reference for full details on all available endpoints.

Searching

Once your entries are in a collection, Datalumo automatically chunks and embeds the text for semantic search. You can search by meaning — not just keywords.

curl "https://datalumo.app/api/v1/collections/{collection}/search?query=how+do+refunds+work" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

You can also generate AI summaries of matching results using the summarise endpoint, or have a full conversation using the chat endpoint.

Integrations

Integrations let you embed Datalumo functionality directly on your website. There are three types:

  • Chatbot — an AI chat widget that answers questions from your collection data
  • Search Box — a search interface with semantic results and optional AI summaries
  • Custom — a flexible integration for custom search implementations

Integrations can be created from the dashboard or via the API.

Embedding on your site

Once you've created an integration, you can embed it on your website using a simple script tag:

<script src="https://datalumo.app/embed/datalumo.js"></script>
<script>
  Datalumo.init('your-integration-public-id');
</script>

The embed script automatically loads the correct widget based on your integration type (chatbot or search box) and applies your configured settings — accent color, position, allowed domains, and more.

For WordPress sites, see the WordPress Plugin documentation.