Docs

Credits, waterfalls, and the enrich object.

Base URL https://api.truffen.shop. Bearer tokens start with trf_live_. OpenAPI lives at /v1/openapi.json.

Quickstart

Create a project in the console, copy a test token, and hit the smallest route. Ujjwal Kumar Singh issues the first live token after a short call.

curl -s https://api.truffen.shop/v1/health \
  -H "Authorization: Bearer trf_live_test"

Send Authorization: Bearer on every call. Rotate keys from the console. Test keys cannot touch production objects.

JSON in, JSON out. Idempotency keys on writes. List routes take cursor and limit. Errors use type, message, and request_id.

POST /v1/search
POST /v1/scrape
POST /v1/enrich
POST /v1/monitors

Default 30 requests per second per key on Root. Burst tokens refill each minute. File a note to ceo@truffen.shop if a launch needs a higher ceiling.

Incident notes go to ceo@truffen.shop. Webhooks retry for 24 hours with exponential backoff. Monitor hits POST a change object to the URL you set.