Search content, narratives, patterns and creators

{
  "content": [
    {
      "authorReach": 1.1,
      "commentCount": 1.1,
      "engagementDepth": 1.1,
      "engagementScore": 1.1,
      "exampleRankingScore": 1.1,
      "likeCount": 1.1,
      "narrativeIds": [
        "string"
      ],
      "patternKeys": [
        "string"
      ],
      "rawSimilarity": 1.1,
      "recencyScore": 1.1,
      "rrfScore": 1.1,
      "shareCount": 1.1,
      "similarity": 1.1,
      "tags": [
        "string"
      ],
      "uuid": "string",
      "viewCount": 1.1,
      "contentType": "string",
      "creatorId": 1.1,
      "description": "string",
      "enrichment": {
        "aestheticStyle": [
          "string"
        ],
        "attributeConfidence": 1.1,
        "brandProducts": [
          "string"
        ],
        "coverage": {
          "attributes": true,
          "novelty": true,
          "sentiment": true
        },
        "emotionMood": [
          "string"
        ],
        "noveltyScore": 1.1,
        "saturationScore": 1.1,
        "themes": [
          "string"
        ],
        "tone": "string",
        "toneConfidence": 1.1
      },
      "followerCount": 1.1,
      "intentEvidenceSource": "authored_text",
      "intentSimilarity": 1.1,
      "platform": "string",
      "publishedAt": "string",
      "relevance": 1.1,
      "title": "string"
    }
  ],
  "creators": [
    {
      "creatorId": 1.1,
      "followerCount": 1.1,
      "hits": 1.1,
      "platform": "string"
    }
  ],
  "narratives": [
    {
      "computed_at": "string",
      "content_count": 1.1,
      "creator_count": 1.1,
      "emerging_score": 1.1,
      "id": "string",
      "label": "string",
      "momentum_score": 1.1,
      "platform_count": 1.1,
      "score_breakdown": {
        "content_count": 1.1,
        "creator_count": 1.1,
        "platform_count": 1.1,
        "total_engagement": 1.1,
        "clustering_method": "string",
        "pair_count": 1.1,
        "seed_tag": "string"
      },
      "source": "emergent",
      "summary": "string",
      "top_tags": [
        "string"
      ],
      "total_engagement": "string",
      "window_end": "string",
      "window_key": "30d",
      "window_start": "string",
      "acceleration": 1.1,
      "diffusion": 1.1,
      "lifecycle": "string",
      "memberOverlap": 1.1,
      "narrative_key": "string",
      "overlapZScore": 1.1,
      "overlap_count": 1.1,
      "queryRelevance": 1.1,
      "representative_content_uuid": "string",
      "sentiment_breakdown": {
        "coverage": 1.1,
        "dominant_tone": "string",
        "stance": {
          "critical": 1.1,
          "mixed": 1.1,
          "neutral": 1.1,
          "supportive": 1.1
        },
        "stance_coverage": 1.1
      },
      "sentiment_label": "string",
      "sentiment_score": 1.1,
      "text_rank": 1.1,
      "trajectory_confidence": "string",
      "velocity": 1.1
    }
  ],
  "patterns": [
    {
      "lexicalMatch": 1.1,
      "lookalikes": [
        {
          "centroidCosine": 1.1,
          "corroborationCount": 1.1,
          "label": "string",
          "patternKey": "string",
          "sharedElements": {},
          "tagJaccard": 1.1
        }
      ],
      "memberTextMatch": 1.1,
      "pattern": {
        "clusteringMethod": "string",
        "confidence": 1.1,
        "contentCount": 1.1,
        "creatorCount": 1.1,
        "earlyCount": 1.1,
        "firstSeenAt": "string",
        "generation": "string",
        "label": "string",
        "labelSource": "string",
        "lateCount": 1.1,
        "lateShare": 1.1,
        "medoidContentUuids": [
          "string"
        ],
        "patternKey": "string",
        "platformCount": 1.1,
        "reconciliation": {
          "cosine": 1.1,
          "memberOverlap": 1.1
        },
        "recurrentElements": [
          {
            "support": 1.1,
            "type": "string",
            "value": "string"
          }
        ],
        "scopeDays": 1.1,
        "summary": "string",
        "tagAttachedMembers": 1.1,
        "totalEngagement": 1.1,
        "trajectory": [
          {
            "contentCount": 1.1,
            "creatorCount": 1.1,
            "generation": "string"
          }
        ]
      },
      "queryRelevance": 1.1,
      "representativeContent": [
        {
          "centroidSimilarity": 1.1,
          "contentUrl": "string",
          "contentUuid": "string",
          "description": "string",
          "engagement": 1.1,
          "isRepresentative": true,
          "platform": "string",
          "publishedAt": "string",
          "title": "string"
        }
      ],
      "visualSimilarity": 1.1
    }
  ],
  "query": "string",
  "request_id": "string",
  "response_time_ms": 1.1,
  "usage": {
    "credits": 1.1
  },
  "window": "30d"
}

Synchronous search over the live corpus. Returns up to limit ranked content rows (default 100, max 300) plus the narratives, patterns and creators they belong to, with ids for GET /narratives/{id} and GET /intelligence/patterns/{patternKey} (patterns is currently always empty while it is switched off). Costs $0.010 per content row returned. A search that runs past its time budget returns 202 with an insights job to poll. For larger pulls or deep analysis, use POST /intelligence/jobs.

Authentication

x-api-keystring

Customer secret key, required on every request. Validated natively by API Gateway; missing / invalid / revoked → 403.

Request

This endpoint expects an object.

querystringRequired>=1 character

Free-text query.

limitdoubleOptional

Max content rows to return (default 100, max 300). Larger pulls belong to a records job.

windowenumOptional

7d, 30d, 90d or all. Defaults to 30d.

Allowed values:

Response headers

X-Kinetk-Credits-Useddouble

Credits consumed by this call (reserved estimate on a 202; actual once settled).

X-Kinetk-Credits-Remainingdouble

Account credit balance remaining after this call.

Response

Successful response

contentlist of objects

creatorslist of objects

narrativeslist of objects

patternslist of objects

querystring

request_idstring

Request id; quote it when contacting support about a call.

response_time_msdouble

usageobject

windowenum

Allowed values:

Errors

400

Bad Request Error

402

Payment Required Error