API basics

The plugin is just a client

Everything the WordPress plugin does is a REST call you can make yourself. Push documents from any stack, and query search, facets, overviews and recommendations directly.

Authenticate with your API key as a bearer token. Your key is scoped to your index.

Indexing a document

Send the content you want searchable. Re-sending the same source_id updates that document rather than duplicating it.

curl -X POST https://rag.isclabs.ai/ingest \
  -H "Authorization: Bearer $ISC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_id": "article-123",
    "title": "Serving displaced families",
    "url": "https://example.org/articles/serving-displaced-families",
    "content": "Full text of the article…",
    "post_type": "article",
    "published_at": "2026-02-01T00:00:00Z",
    "metadata": { "facets": { "topic": [{ "id": "relief", "label": "Relief" }] } }
  }'

Searching

Filters accept exact values, and date or numeric ranges.

curl -G https://rag.isclabs.ai/search \
  -H "Authorization: Bearer $ISC_API_KEY" \
  --data-urlencode "q=helping refugees" \
  --data-urlencode 'filters={"topic":["Relief"],"post_date":{"gte":"2025-01-01"}}' \
  --data-urlencode "limit=10"

Removing content

Delete a document by its source_id when it stops being public. Deleting something already absent is harmless, so you can call it freely.