SourceFinder API

OpenAPI reference for the SourceFinder service.

Base URL

https://api.coinpost.ai/sourcefinder

Authentication

Send the API key in the CP-X-API-KEY header.

Example format:

CP-X-API-KEY: <your-api-key>

Endpoints

• GET /health — Health check
• POST /sources — Submit an asynchronous source-finding job
• GET /sources/{id} — Get job status or result

Request Notes

• POST /sources requires at least one of title, content, or source_urls
• Optional request-level LLM overrides belong under llm
• collected_at can provide a reference timestamp for incomplete or relative dates

Response Convention

• Source-finding job responses wrap data in a data field; /health returns service metadata directly
• Error responses return error with a message string
• Job results include a status field (pending, processing, completed, failed)
• Completed results can include primary_sources, original_urls, metrics, and truth_assessment