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

# Overview

The Social Posts API returns social media posts published by any company, sourced from platforms such as LinkedIn. A single request returns a paginated list of posts, each with its content type, text body, publish date, paid and repost flags, an AI-assigned classification, mentions, and a detailed breakdown of engagement metrics such as reactions (by type), comments, and reposts.

A company's social output is a live read on its brand and marketing activity: how often it posts, what themes it leans into (product, brand, hiring, thought leadership), which formats it favors (image, video, document), and crucially how its audience responds. Engagement metrics broken out by reaction type make it possible to distinguish a post that was merely *seen* from one that genuinely *resonated*, and the `post_classification` field lets you analyze content mix and performance by theme.

This is a **synchronous GET API**. Pass a company identifier and optional pagination parameters (`limit` and `offset`) and receive the posts immediately. The response also reports the total number of posts available and the credits consumed by the request.

<Info>
  This API is synchronous. Results are returned directly in the HTTP response. No job submission or polling required.
</Info>
