Skip to main content
GET
Social Posts

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

string
required
Your API key.

URL Parameters

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.
integer
Maximum number of posts to return.Default = 10
integer
Number of posts to skip before returning records. Use with limit for pagination.Default = 0

Response

Successful Response Fields

Returns a JSON object with the following structure:
object
Container object holding the company’s social posts. See Data Object Fields below.
integer
Total number of posts available for the company based on the filters set.
integer
Limit applied to the request.
integer
Offset applied to the request.
float
Credits consumed by the request.

Data Object Fields

string
Akta UUID of the company.
array
List of social post objects. See Post Object Fields below.

Post Object Fields

string
Unique identifier for the post.
string
Format of the post. Example values: image, document, linkedInVideo, text.
string
Link to the original post on the source platform.
string
Timestamp the post was published, in ISO 8601 format with timezone.
boolean
true if the post was a paid/promoted post.
boolean
true if the post is a repost of other content rather than original.
string
The text body of the post.
string
AI-assigned classification of the post’s theme. Example values: Product & technology, Brand & occasion, Other.
object
Author details for the post. May be an empty object when not available.
array
Entities or accounts mentioned in the post. May be an empty array.
object
Engagement counts for the post. See Engagement Metrics Object below.

Engagement Metrics Object

integer
Total number of reactions across all reaction types.
integer
Number of “like” reactions.
integer
Number of “empathy” / support reactions.
integer
Number of “praise” / celebrate reactions.
integer
Number of “appreciation” reactions.
integer
Number of “interest” reactions.
integer
Number of “funny” reactions.
integer
Number of comments on the post.
integer
Number of times the post was reposted / shared.

Authorizations

x-api-key
string
header
required

API key obtained from your Akta account.

Query Parameters

company
string
required

Company website (e.g. 'canva.com') or a company UUID. The UUID can be obtained from the Company Search API.

limit
integer
default:10

Maximum number of posts to return.

offset
integer
default:0

Number of posts to skip before returning records.

Response

Social posts returned

data
object
count
integer
limit
integer
offset
integer
credits_consumed
number<float>