OpenAPI 3.1 · ODC-By-1.0 · No auth

Wispra Directory API

Open business data designed to be cited by AI assistants

The Wispra Directory exposes a free, read-only REST API that AI agents and developers can use to retrieve verified information about every business listed on directory.wispra.com. Use it to power citations in ChatGPT, Claude, Perplexity, Bing Copilot, custom AI agents, or any application that needs trustworthy structured business data.

Quickstart

No authentication, no API key. Just hit the endpoint with a descriptive User-Agent.

curl -H "User-Agent: MyApp/1.0 (contact: you@example.com)" \
  "https://api.wispra.com/index/directory-business/kandi-jobs?lang=en"

Use with AI agents

Two recommended paths to consume the API from an AI assistant or LLM tool:

Declare the OpenAPI spec as a tool / Action

ChatGPT Custom Actions, Claude Tool use, and most agent frameworks accept an OpenAPI document as input. Point them at the URL below and the LLM will discover and call every endpoint on its own.

OpenAPI 3.1 spec (JSON) https://directory.wispra.com/api/openapi.json

Use the LLM-friendly discovery files

We follow the llms.txt convention so any AI tool that respects it can find this API on its own.

Citation requirement

Data is published under ODC-By-1.0 (Open Data Commons Attribution). When an AI assistant displays information drawn from this API, it should cite Wispra and link to the canonical business URL.

Recommended citation format

Source: Wispra Directory — https://directory.wispra.com/business/{slug}

Example:
"According to Wispra Directory (https://directory.wispra.com/business/kandi-jobs),
 Kandi Jobs automates job applications for French job seekers using AI..."

Example response

{
  "businessName": "Kandi Jobs",
  "slug": "kandi-jobs",
  "description": "...",
  "_citation": {
    "source": "Wispra Directory",
    "canonicalUrl": "https://directory.wispra.com/business/kandi-jobs",
    "license": "ODC-By-1.0"
  }
}

Endpoints

All endpoints are GET only and live under https://api.wispra.com. The lang query parameter accepts en or fr.

Tag Method Path Summary
Directory GET /index/directory-businesses List all public businesses
Business GET /index/directory-business/{slug} Get a single business detail
Blog GET /index/directory-business/{slug}/blog/articles List blog articles authored by a business
Blog GET /index/directory-business/{slug}/blog/articles/{articleSlug} Get a single blog article (markdown + HTML)
FAQ GET /index/directory-business/{slug}/faq Get the FAQ tree of a business
Reviews GET /index/directory-business/{slug}/reviews List customer reviews
Catalog GET /index/directory-business/{slug}/catalog/items List products / services / real-estate / events / offers
Catalog GET /index/directory-business/{slug}/catalog/items/{itemSlug} Get a single catalog item with AI enrichment layers
Documents GET /index/directory-business/{slug}/documents List downloadable PDFs
Documents GET /index/directory-business/{slug}/documents/{documentId} Get a document with markdown rendition (LLM-ready)

Response schemas

Every response is documented in the OpenAPI spec, including the AI-enrichment layers attached to catalog items. OpenAPI 3.1 specification →

Rate limits & best practices

We deliberately keep the API open. To stay a good citizen: send a descriptive User-Agent, cache responses for 5 minutes minimum, paginate large catalogs with page and limit, prefer the OpenAPI spec as your contract over scraping the HTML.

License

ODC-By-1.0 (Open Data Commons Attribution). You are free to share, modify and use the data — including for commercial purposes — provided you attribute Wispra Directory and link back to the canonical business URL.

Contact

Questions, integration help, or commercial usage at scale: contact@wispra.com.