---
title: "Aggregate profiles into social intelligence"
method: POST
path: "/intelligence/aggregate"
tags: ["Profiles"]
---

# Aggregate profiles into social intelligence

`POST /intelligence/aggregate`

## Request

- Base URL: `https://api.socially.run/v1`
- URL: `https://api.socially.run/v1/intelligence/aggregate`
- Auth: HTTP bearer

Turn one or more profile reads (the six ExtractionResult keys) into the consolidated SocialIntelligence document: engagement, sentiment, content calendar, benchmark, a pt-BR knowledge-base markdown and personality hints. Pure and free. It only computes over what you send.

## Request body

- object
  - `results` object[], required
    - `platform` 'instagram' | 'linkedin' | 'youtube' | 'tiktok' | 'x' | 'facebook' | 'website', required
    - `url` string, required
    - `extractedAt` string, required
    - `profile` object, required
      - `name` string, required
      - `username` string, required
      - `bio` string, required
      - `followers` number, nullable, required
      - `following` number, nullable, required
      - `postsCount` number, nullable, required
      - `profileUrl` string, required
      - `avatarUrl` string, nullable, required
      - `isVerified` boolean, nullable
      - `isBusinessAccount` boolean, nullable
      - `businessCategory` string, nullable
      - `externalUrl` string, nullable
    - `recentPosts` object[], required
      - `text` string, required
      - `date` string, nullable, required
      - `likes` number, nullable, required
      - `comments` number, nullable, required
      - `shares` number, nullable, required
      - `views` number, nullable, required
      - `url` string, nullable, required
      - `thumbnail` string, nullable
      - `duration` string, nullable
      - `hashtags` string[]
      - `mediaType` 'video' | 'image' | 'carousel' | 'article' | 'short' | 'reel', nullable
    - `summary` string, required

## Response `200`

Aggregate profiles into social intelligence

- object
  - `data` unknown, required

## Other responses

- `400`: VALIDATION_ERROR / INVALID_TARGET / SSRF_BLOCKED: the issues, never the values.
- `401`: UNAUTHORIZED / INVALID_TOKEN: the key is missing or wrong.
- `402`: PAYMENT_REQUIRED / PLAN_GATE: clears by upgrading or buying credits, never by waiting.
- `429`: RATE_LIMIT_EXCEEDED / QUOTA_EXCEEDED: Retry-After says when it clears.
- `default`: Any other failure.

---

[API](https://skmtc.dev/socially/apis/socially-run-send-a-profile-link-get-its-public-data-as-json.md) · [All operations](https://skmtc.dev/socially/apis/socially-run-send-a-profile-link-get-its-public-data-as-json/llms.txt) · [OpenAPI document](https://skmtc.dev/socially/apis/socially-run-send-a-profile-link-get-its-public-data-as-json/revisions/5a0b24534b90?raw)