> ## Documentation Index
> Fetch the complete documentation index at: https://agent-docs.akta.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Social Posts API

> Fetches social media posts published by a company, including content type, text, publish date, paid/repost flags, an AI classification, and detailed engagement metrics.

## Overview

The Social Posts API returns social media posts published by a company, sourced from platforms such as LinkedIn. Each post includes its content type, text, publish date, paid and repost flags, an AI-assigned classification, mentions, and a detailed breakdown of engagement metrics (reactions, likes, comments, reposts, and more). Tracking a company's posting cadence, content mix, and engagement is a useful proxy for brand activity and marketing momentum. Results are paginated and returned in the API response.

## Endpoint Details

* **Method:** GET
* **Endpoint:** `/api/v1/company/posts`

## Authentication requirements

* Include a valid API key in the `x-api-key` request header.

## Request

### Request Parameters

#### Header Parameters

<ParamField header="x-api-key" type="string" required>
  Your API key.
</ParamField>

## URL Parameters

<ParamField query="company" type="string" required>
  Company website (e.g. `canva.com`) or a company UUID (e.g. `00000l1`). The UUID can be obtained from the Company Search API.
</ParamField>

<ParamField query="limit" type="integer">
  Maximum number of posts to return.

  Default = 10
</ParamField>

<ParamField query="offset" type="integer">
  Number of posts to skip before returning records. Use with `limit` for pagination.

  Default = 0
</ParamField>

## Response

#### Successful Response Fields

Returns a JSON object with the following structure:

<ResponseField name="data" type="object">
  Container object holding the company's social posts. See **Data Object Fields** below.
</ResponseField>

<ResponseField name="count" type="integer">
  Total number of posts available for the company based on the filters set.
</ResponseField>

<ResponseField name="limit" type="integer">
  Limit applied to the request.
</ResponseField>

<ResponseField name="offset" type="integer">
  Offset applied to the request.
</ResponseField>

<ResponseField name="credits_consumed" type="float">
  Credits consumed by the request.
</ResponseField>

#### Data Object Fields

<ResponseField name="uuid" type="string">
  Akta UUID of the company.
</ResponseField>

<ResponseField name="posts" type="array">
  List of social post objects. See **Post Object Fields** below.
</ResponseField>

#### Post Object Fields

<ResponseField name="id" type="string">
  Unique identifier for the post.
</ResponseField>

<ResponseField name="content_type" type="string">
  Format of the post. Example values: `image`, `document`, `linkedInVideo`, `text`.
</ResponseField>

<ResponseField name="url" type="string">
  Link to the original post on the source platform.
</ResponseField>

<ResponseField name="posted_date" type="string">
  Timestamp the post was published, in ISO 8601 format with timezone.
</ResponseField>

<ResponseField name="is_paid" type="boolean">
  `true` if the post was a paid/promoted post.
</ResponseField>

<ResponseField name="reposted" type="boolean">
  `true` if the post is a repost of other content rather than original.
</ResponseField>

<ResponseField name="text_content" type="string">
  The text body of the post.
</ResponseField>

<ResponseField name="post_classification" type="string">
  AI-assigned classification of the post's theme. Example values: `Product & technology`, `Brand & occasion`, `Other`.
</ResponseField>

<ResponseField name="author" type="object">
  Author details for the post. May be an empty object when not available.
</ResponseField>

<ResponseField name="mentions" type="array">
  Entities or accounts mentioned in the post. May be an empty array.
</ResponseField>

<ResponseField name="engagement_metrics" type="object">
  Engagement counts for the post. See **Engagement Metrics Object** below.
</ResponseField>

#### Engagement Metrics Object

<ResponseField name="total_reaction_count" type="integer">
  Total number of reactions across all reaction types.
</ResponseField>

<ResponseField name="like_count" type="integer">
  Number of "like" reactions.
</ResponseField>

<ResponseField name="empathy_count" type="integer">
  Number of "empathy" / support reactions.
</ResponseField>

<ResponseField name="praise_count" type="integer">
  Number of "praise" / celebrate reactions.
</ResponseField>

<ResponseField name="appreciation_count" type="integer">
  Number of "appreciation" reactions.
</ResponseField>

<ResponseField name="interest_count" type="integer">
  Number of "interest" reactions.
</ResponseField>

<ResponseField name="funny_count" type="integer">
  Number of "funny" reactions.
</ResponseField>

<ResponseField name="comments_count" type="integer">
  Number of comments on the post.
</ResponseField>

<ResponseField name="reposts_count" type="integer">
  Number of times the post was reposted / shared.
</ResponseField>

<ResponseExample>
  ```json 200 expandable wrap theme={null}
  {
    "count": 396,
    "limit": 10,
    "offset": 0,
    "data": {
      "uuid": "00000l1",
      "posts": [
        {
          "id": "WXN2OJ3HV7",
          "content_type": "document",
          "url": "https://www.linkedin.com/feed/update/urn:li:activity:7493984848869715968/",
          "posted_date": "2026-08-14 11:00:19.476000+00:00",
          "is_paid": false,
          "reposted": false,
          "engagement_metrics": {
            "total_reaction_count": 270,
            "like_count": 226,
            "empathy_count": 36,
            "praise_count": 3,
            "appreciation_count": 0,
            "interest_count": 3,
            "funny_count": 0,
            "comments_count": 0,
            "reposts_count": 12
          },
          "text_content": "Fonts for when the vibes are grain, filters, and a candid moment. Save these for your next design!  \n\nNow fill in the blank: Fonts that give _______. We might do yours next. 😉",
          "post_classification": "Other",
          "author": {},
          "mentions": []
        },
        {
          "id": "WXC9MJ3SU4",
          "content_type": "document",
          "url": "https://www.linkedin.com/feed/update/urn:li:activity:7493622474518048768/",
          "posted_date": "2026-08-13 11:00:22.698000+00:00",
          "is_paid": false,
          "reposted": false,
          "engagement_metrics": {
            "total_reaction_count": 131,
            "like_count": 113,
            "empathy_count": 13,
            "praise_count": 2,
            "appreciation_count": 0,
            "interest_count": 0,
            "funny_count": 3,
            "comments_count": 0,
            "reposts_count": 5
          },
          "text_content": "#WhatsNew? Add images and videos to comments! 🤩 \nMake your feedback even clearer with a reference, recommendation, or good old reaction pic. \n\nWhat photo are you using to get approvals faster? Drop it in the comments!",
          "post_classification": "Other",
          "author": {},
          "mentions": []
        },
        {
          "id": "WXG2S52QAP",
          "content_type": "document",
          "url": "https://www.linkedin.com/feed/update/urn:li:activity:7493260080226906112/",
          "posted_date": "2026-08-12 11:00:21.166000+00:00",
          "is_paid": false,
          "reposted": false,
          "engagement_metrics": {
            "total_reaction_count": 349,
            "like_count": 267,
            "empathy_count": 42,
            "praise_count": 6,
            "appreciation_count": 0,
            "interest_count": 2,
            "funny_count": 28,
            "comments_count": 0,
            "reposts_count": 9
          },
          "text_content": "Kinda chic to design with Canva 😉 What’s your version of this?",
          "post_classification": "Other",
          "author": {},
          "mentions": []
        },
        {
          "id": "WX1QA3MQFA",
          "content_type": "linkedInVideo",
          "url": "https://www.linkedin.com/feed/update/urn:li:activity:7492897649436639232/",
          "posted_date": "2026-08-11 11:00:10.932000+00:00",
          "is_paid": false,
          "reposted": false,
          "engagement_metrics": {
            "total_reaction_count": 217,
            "like_count": 180,
            "empathy_count": 24,
            "praise_count": 5,
            "appreciation_count": 0,
            "interest_count": 1,
            "funny_count": 3,
            "comments_count": 0,
            "reposts_count": 9
          },
          "text_content": "In a world full of busy nine-to-fives, what do you make time for? 🤔💬",
          "post_classification": "Other",
          "author": {},
          "mentions": []
        },
        {
          "id": "WX7AD2EHNC",
          "content_type": "linkedInVideo",
          "url": "https://www.linkedin.com/feed/update/urn:li:activity:7492535330345111552/",
          "posted_date": "2026-08-10 11:00:27.329000+00:00",
          "is_paid": false,
          "reposted": false,
          "engagement_metrics": {
            "total_reaction_count": 231,
            "like_count": 201,
            "empathy_count": 25,
            "praise_count": 3,
            "appreciation_count": 0,
            "interest_count": 2,
            "funny_count": 0,
            "comments_count": 0,
            "reposts_count": 7
          },
          "text_content": "Looking for design inspiration? Here’s a creative idea for the videos already in your camera roll. 🤳🏻",
          "post_classification": "Other",
          "author": {},
          "mentions": []
        },
        {
          "id": "WXPWIE1OJA",
          "content_type": "document",
          "url": "https://www.linkedin.com/feed/update/urn:li:activity:7491448177095770112/",
          "posted_date": "2026-08-07 11:00:29.796000+00:00",
          "is_paid": false,
          "reposted": false,
          "engagement_metrics": {
            "total_reaction_count": 221,
            "like_count": 168,
            "empathy_count": 18,
            "praise_count": 2,
            "appreciation_count": 0,
            "interest_count": 1,
            "funny_count": 32,
            "comments_count": 0,
            "reposts_count": 12
          },
          "text_content": "We heard you found chronically online mode. 🤪🤳🏻 And the search results are... interesting. This you, bestie?\n\nLock in and turn it on:\n1️⃣ Open Canva\n2️⃣ Your Account > Language > English (chronically online)\n3️⃣ Search “pizza”, “contact”, and “phone” – for research purposes.\n\nHave fun!",
          "post_classification": "Other",
          "author": {},
          "mentions": []
        },
        {
          "id": "WXEXNIG0X9",
          "content_type": "linkedInVideo",
          "url": "https://www.linkedin.com/feed/update/urn:li:activity:7491266929437986816/",
          "posted_date": "2026-08-06 23:00:16.987000+00:00",
          "is_paid": false,
          "reposted": false,
          "engagement_metrics": {
            "total_reaction_count": 68,
            "like_count": 68,
            "empathy_count": 0,
            "praise_count": 0,
            "appreciation_count": 0,
            "interest_count": 0,
            "funny_count": 0,
            "comments_count": 0,
            "reposts_count": 3
          },
          "text_content": "What's one goal you'd like to see achieved in your lifetime? 👇\n\nTurns out, when you ask people this question, they almost always have an answer. But what's been missing is somewhere to put these hopes, and a way to see how many other people are holding onto that same vision.\n\nThis is the ambition of our USA Goals initiative. In partnership with the Ad Council, we’re inviting Americans everywhere to share the goals they want to see realized. \n\nLearn more here: https://lnkd.in/ecARjEuT\n\n #USAGoals",
          "post_classification": "People & culture",
          "author": {},
          "mentions": [
            {
              "name": "Ad Council",
              "linkedin_url": "https://www.linkedin.com/company/the-advertising-council/",
              "mention_type": "company",
              "linkedin_public_identifier": "the-advertising-council"
            }
          ]
        },
        {
          "id": "WX8HOIKXXW",
          "content_type": "image",
          "url": "https://www.linkedin.com/feed/update/urn:li:activity:7491085724746858497/",
          "posted_date": "2026-08-06 11:00:14.422000+00:00",
          "is_paid": false,
          "reposted": false,
          "engagement_metrics": {
            "total_reaction_count": 79,
            "like_count": 65,
            "empathy_count": 9,
            "praise_count": 2,
            "appreciation_count": 0,
            "interest_count": 0,
            "funny_count": 3,
            "comments_count": 0,
            "reposts_count": 3
          },
          "text_content": "It’s either snoozing 5x or waking up right before the alarm goes off – there’s no in between. \n\nAre you a morning person or a night owl? ⛅️🦉Drop your routines: https://lnkd.in/eCWuknVR",
          "post_classification": "Other",
          "author": {},
          "mentions": []
        },
        {
          "id": "WXDVVT2FF1",
          "content_type": "document",
          "url": "https://www.linkedin.com/feed/update/urn:li:activity:7490723342371663872/",
          "posted_date": "2026-08-05 11:00:15.731000+00:00",
          "is_paid": false,
          "reposted": false,
          "engagement_metrics": {
            "total_reaction_count": 25,
            "like_count": 22,
            "empathy_count": 0,
            "praise_count": 0,
            "appreciation_count": 0,
            "interest_count": 0,
            "funny_count": 2,
            "comments_count": 0,
            "reposts_count": 2
          },
          "text_content": "👀 We trust the Canva stans. Comment your vote! 👇",
          "post_classification": "Other",
          "author": {},
          "mentions": []
        },
        {
          "id": "WXQZM42QAE",
          "content_type": "linkedInVideo",
          "url": "https://www.linkedin.com/feed/update/urn:li:activity:7490360996130279424/",
          "posted_date": "2026-08-04 11:00:25.655000+00:00",
          "is_paid": false,
          "reposted": false,
          "engagement_metrics": {
            "total_reaction_count": 186,
            "like_count": 160,
            "empathy_count": 16,
            "praise_count": 6,
            "appreciation_count": 0,
            "interest_count": 3,
            "funny_count": 0,
            "comments_count": 0,
            "reposts_count": 18
          },
          "text_content": "Canva Code just leveled up! Use the same prompt, get a way better output. Here’s what you can build now 👉 https://lnkd.in/ecqfxfkD",
          "post_classification": "Product & technology",
          "author": {},
          "mentions": []
        }
      ]
    },
    "credits_consumed": 1
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /v1/company/posts
openapi: 3.0.3
info:
  title: Akta.pro API
  description: >
    Akta provides APIs for company intelligence and news monitoring:


    1. **News** – Enriched news articles with AI summaries, sentiment, event
    tags, industry classifications, and company mention resolution.

    2. **Company Enrichment** – Structured company data including firmographics,
    funding, headcount, and financials.

    3. **Company Search** – Free endpoint to resolve company names, domains, or
    UUIDs.

    4. **Product Reviews** – G2 product reviews with ratings and review content.

    5. **Employee Reviews** – Employee sentiment data with workplace ratings.


    **Authentication:** All endpoints require an API key in the `x-api-key` HTTP
    header.
  version: 1.0.0
  contact:
    url: https://akta.pro
servers:
  - url: https://api.akta.pro/api
    description: Production server
security: []
tags:
  - name: News
    description: Enriched news articles with AI summaries, sentiment, and company mentions
  - name: Company
    description: Company data enrichment, search, and addition
  - name: Reviews
    description: Product and employee reviews from external sources
  - name: Supporting APIs
    description: Utility endpoints for request tracking
  - name: List Generation
    description: >-
      Build targeted company lists using structured filters or natural language
      queries
externalDocs:
  description: Official Akta.pro API Documentation
  url: https://docs.akta.pro
paths:
  /v1/company/posts:
    get:
      tags:
        - Company
      summary: Social Posts
      description: >
        Fetches social media posts published by a company, including content
        type, text, publish date, paid/repost flags, an AI classification, and
        detailed engagement metrics.
      operationId: getSocialPosts
      parameters:
        - name: company
          in: query
          required: true
          schema:
            type: string
          description: >-
            Company website (e.g. 'canva.com') or a company UUID. The UUID can
            be obtained from the Company Search API.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 10
          description: Maximum number of posts to return.
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            default: 0
          description: Number of posts to skip before returning records.
      responses:
        '200':
          description: Social posts returned
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                  count:
                    type: integer
                  limit:
                    type: integer
                  offset:
                    type: integer
                  credits_consumed:
                    type: number
                    format: float
        '401':
          description: Unauthorized — missing or invalid API key.
      security:
        - xApiKeyAuth: []
components:
  securitySchemes:
    xApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key obtained from your Akta account.

````