---
title: "Create and stream a Social Profile Analysis job"
method: POST
path: "/v1/social-profile-analysis/stream"
tags: ["social-profile-analysis"]
---

# Create and stream a Social Profile Analysis job

`POST /v1/social-profile-analysis/stream`

Create a persisted Social Profile Analysis job and stream typed server-sent events until completion. Use the `X-Job-Id` response header to reconnect at `GET /v1/social-profile-analysis/jobs/{job_id}/stream`.

## Request body

- SocialProfileAnalysisRequest — Social Profile Analysis request payload.
  - `analysisTypes` AnalysisType[]
  - `behavioralAnalysis` BehavioralAnalysisConfig — Optional interpretation layer that uses Match output as input.
    - `enabled` boolean
    - `focus` string[]
    - `targetContext` TargetContext
      - `description` string, nullable
      - `name` string, required
      - `type` 'person' | 'organization' | 'school' | 'company' | 'public_figure' | 'event' | 'location' | 'institution' | 'other'
    - `timeBucket` 'day' | 'week' | 'month'
  - `match` SocialProfileAnalysisMatchConfig, required — Base Match configuration for selecting relevant records.
    - `confidenceThreshold` number
    - `criteria` string[]
    - `customPrompt` string, nullable
    - `dataTypes` SocialDataType[]
    - `maxRecords` integer
    - `timeRange` SocialAnalysisTimeRange
      - `end` string, nullable
      - `start` string, nullable
  - `subject` SocialProfileAnalysisSubject, required — Known profile subject for social profile analysis.
    - `name` string, required
    - `socialMediaUrls` string[]

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/intraceai/apis/intelligence-api.md) · [All operations](https://skmtc.net/intraceai/apis/intelligence-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/intraceai/intelligence-api/revisions/c0216eef7380/schema)