Skip to navigation
Get Started

Introduction

KINETK turns scattered social posts into a connected map of narratives, creators and patterns

The KINETK Graph Service API is the multimodal content intelligence platform of the social web. It generates narratives and visual patterns across TikTok, Instagram, Reddit, Pinterest, X, Snapchat and more.

There are two ways to use it:

  • HTTP API — REST endpoints behind an API key. Best for backends, dashboards, scheduled jobs and agents you build yourself.
  • MCP server — a hosted Model Context Protocol server that exposes the graph as tools in Claude, ChatGPT, Cursor, Codex and other AI assistants.

Both reach the same backend and bill the same account.

Get Your API Key

Create a key in the KINETK platform to start making requests.

What you can do

CapabilityEndpointSpeedCost
Ranked content + its narratives and creators, in one callPOST /searcha few seconds0.01 credits per record
Trending narrativesGET /narratives/trendingunder 2 sfree
Search the narrative mapGET /narratives/searchunder 2 sfree
One narrative: posts, creators, platform splitGET /narratives/{id}under 3 sfree
A narrative’s momentum over timeGET /narratives/{id}/trajectoryunder 2 sfree
Browse the visual pattern mapGET /intelligence/patternsunder 2 sfree
One pattern, its posts and its lookalikesGET /intelligence/patterns/{patternKey} (+ /content, /lookalikes)under 2 sfree
Deep retrieval and analysis: records, insights, patterns, statsPOST /intelligence/jobs + GET /intelligence/jobs/{id}asyncper record or per call
Your credit historyGET /usageunder 1 sfree
Service status and data freshnessGET /healthunder 1 sfree

Three kinds of call sit behind that table:

  • Precomputed reads of the narrative and pattern maps, rebuilt on a schedule — instant and free.
  • Synchronous search — one bounded live retrieval, for agents and apps that call many times per task.
  • Async jobs — deep retrieval and analysis over the live corpus. Submit returns a jobId immediately; poll until it succeeds. Identical requests are served from cache.

Not sure which to use? See Choosing the Right Call.

Core concepts

  • Content — a post or video, with normalized relevance, engagement and recency signals and the score it is ranked by. See The Content Object.
  • Narratives — clusters of content a community is talking about, tracked over time with momentum, lifecycle and sentiment. See Narrative Intelligence.
  • Patterns — groups of content that look alike, discovered from images and video, with the visual elements they share. See Pattern Intelligence.

Base URL

https://api.kinetk.ai/graph

Every endpoint requires your secret key in the x-api-key header. Export these so the examples in these docs work as written:

export API_BASE="https://api.kinetk.ai/graph"
export API_KEY="<your key>"

Get started

  1. Quickstart — get an API key, try queries in the Playground, then make your first calls.
  2. Pricing & Credits — what each call costs.
  3. Hosted MCP Setup — connect your AI assistant.