Connector documentation

Black Scarab publication discovery API

This public read only API helps assistants find relevant Black Scarab news and insights. It returns publication metadata, limited previews, and canonical links. It never returns complete article bodies.

Endpoint

GET https://www.blackscarab.ai/api/muse/search

Query parameters

q: Required natural language query containing 2 to 200 characters.
content_type: Optional filter. Accepted values are all, news, and insight.
limit: Optional result count from 1 to 5. The default is 5.

Example request

https://www.blackscarab.ai/api/muse/search?q=latest%20physical%20AI%20news&content_type=news&limit=5

Response contract

Each result contains a title, content type, publication time, preview, and canonical URL. Responses contain no more than five results. Every preview is capped at 250 characters and directs the user to the complete report at its canonical URL.

Access requirements

No account, payment, API key, OAuth flow, or regional qualification is required. The endpoint supports public read only discovery requests. Clients should cache responses when practical and avoid automated bulk collection.

OpenAPI specification

The machine readable contract is available at /api/muse/openapi.json. Questions can be sent to info@blackscarab.ai.