vynt://api/v1

API reference

All endpoints authenticate with a bearer API key, return JSON, and include a request ID. Credit costs are fixed per operation and reported in every response.

Create a key

Authentication

Authorization: Bearer vynt_live_…
Content-Type: application/json

POST/v1/analyze1–5 credits by kind

Runs semantic analysis, writes a provenance record and returns the full index breakdown.

{ "kind": "video|article|document|text|url",
  "platform": "youtube|tiktok|instagram|rss|web|upload",
  "url": "https://…",           // or
  "text": "raw text to index" }

GET/v1/contentfree

Lists your indexed content with semantic index values and topic references.

?limit=20&cursor=…&platform=youtube

GET/v1/content/{vynt_id}free

Returns one item with entities, topics, keywords, index components and provenance.

—

GET/v1/graphfree

Returns nodes and edges for your knowledge graph.

?depth=2&focus=topic:semantic-indexing

POST/v1/verifyfree

Public provenance verification. Returns verified, changed, not_verified or unknown.

{ "query": "vynt_prov_… | <sha256>" }

GET/v1/usagefree

Requests, credits consumed and remaining balance for the current period.

—

Credit costs

text analysis1

metadata extraction1

transcript analysis2

video analysis5

cross platform10

external intelligence20

copilot1

Errors

401Missing or invalid API key.

403The key is revoked, or the resource belongs to another workspace.

402Insufficient credits — no work was performed.

422Validation failed. The response names the offending field.

429Rate limit exceeded. Honour the Retry-After header.

5xxUnexpected failure. The request ID is safe to share with support.