Skip to main content

Project Insights

Aggregate insights across all content in a project.

Get Project Insights​

GET /v1/projects/{projectId}/insights

Returns the latest project insights.

Request​

curl https://scribesight.com/api/v1/projects/proj_xxx/insights \
  -H "Authorization: Bearer sk_live_xxx"

Response​

{
  "data": {
    "id": "ins_xxxxxxxxxxxx",
    "project_id": "proj_xxxxxxxxxxxx",
    "content_analyzed": 47,
    "lookback_days": 30,
    "result": {
      "key_themes": [
        {
          "theme": "Pricing concerns",
          "frequency": 0.68,
          "trend": "increasing"
        },
        {
          "theme": "Implementation timeline",
          "frequency": 0.45,
          "trend": "stable"
        }
      ],
      "sentiment_distribution": {
        "positive": 0.42,
        "neutral": 0.38,
        "negative": 0.20
      },
      "top_action_items": [
        "Follow up on pricing discussions",
        "Provide implementation timeline estimates"
      ],
      "recommendations": [
        "Address pricing concerns earlier in calls",
        "Prepare implementation case studies"
      ]
    },
    "created_at": "2026-01-06T00:00:00Z"
  }
}

List Project Insights History​

GET /v1/projects/{projectId}/insights/history

Returns historical project insights.

Request​

curl "https://scribesight.com/api/v1/projects/proj_xxx/insights/history?limit=10" \
  -H "Authorization: Bearer sk_live_xxx"

Generate Project Insights​

POST /v1/projects/{projectId}/insights/generate

Triggers generation of new project insights.

Request Body​

FieldTypeRequiredDescription
lookback_daysintegerNoDays of content to analyze (default: 30)

Request​

curl -X POST https://scribesight.com/api/v1/projects/proj_xxx/insights/generate \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "lookback_days": 14
  }'

Response​

{
  "data": {
    "insights_id": "ins_yyyyyyyyyyyy",
    "status": "queued",
    "message": "Insights generation queued"
  }
}

Generation runs asynchronously. Use webhooks to be notified when it completes.