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.

GET /v1/company/posts

Social Posts

cURL

curl --request GET \
  --url https://api.akta.pro/api/v1/company/posts \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.akta.pro/api/v1/company/posts"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.akta.pro/api/v1/company/posts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.akta.pro/api/v1/company/posts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.akta.pro/api/v1/company/posts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.akta.pro/api/v1/company/posts")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.akta.pro/api/v1/company/posts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

200

{
  "count": 406,
  "limit": 10,
  "offset": 0,
  "data": {
    "uuid": "00000l1",
    "posts": [
      {
        "id": "WXLOA811U2",
        "content_type": "image",
        "link": "https://www.linkedin.com/feed/update/urn:li:activity:7480953969704419328/",
        "posted_date": "2026-07-09 12:00:15.781000+00:00",
        "is_paid": false,
        "reposted": false,
        "engagement_metrics": {
          "total_reaction_count": 76,
          "like_count": 65,
          "empathy_count": 8,
          "praise_count": 2,
          "appreciation_count": 0,
          "interest_count": 1,
          "funny_count": 0,
          "comments_count": 0,
          "reposts_Count": 2
        },
        "text_content": "Easy-peasy efficiency 🍋✨ Have you got a hack you want to share in the comments?",
        "post_classification": "Other",
        "author": {},
        "mentions": []
      },
      {
        "id": "WXP178134W",
        "content_type": "image",
        "link": "https://www.linkedin.com/feed/update/urn:li:activity:7477677369806479361/",
        "posted_date": "2026-06-30 11:00:13.489000+00:00",
        "is_paid": false,
        "reposted": false,
        "engagement_metrics": {
          "total_reaction_count": 1172,
          "like_count": 985,
          "empathy_count": 125,
          "praise_count": 38,
          "appreciation_count": 0,
          "interest_count": 13,
          "funny_count": 1,
          "comments_count": 0,
          "reposts_Count": 24
        },
        "text_content": "What new Canva tool do you wish we could work on next? 💬",
        "post_classification": "Product & technology",
        "author": {},
        "mentions": []
      }
    ]
  },
  "credits_consumed": 1
}

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: /v1/company/posts

Authentication requirements

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

Request

Request Parameters

Header Parameters

x-api-key · string · required

Your API key.

URL Parameters

company · 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.

limit · integer

Maximum number of posts to return.

Default = 10

offset · integer

Number of posts to skip before returning records. Use with limit for pagination.

Default = 0

Example Request

curl -G "https://api.akta.pro/api/v1/company/posts/" \
  --data-urlencode "company=00000l1" \
  -H "x-api-key: YOUR_API_KEY"

Response

Successful Response Fields

Returns a JSON object with the following structure:

data · object

Container object holding the company’s social posts. See Data Object Fields below.

count · integer

Total number of posts available for the company based on the filters set.

limit · integer

Limit applied to the request.

offset · integer

Offset applied to the request.

credits_consumed · float

Credits consumed by the request.

Data Object Fields

uuid · string

Akta UUID of the company.

posts · array

List of social post objects. See Post Object Fields below.

Post Object Fields

id · string

Unique identifier for the post.

content_type · string

Format of the post. Example values: image, document, linkedInVideo, text.

link · string

Link to the original post on the source platform.

posted_date · string

Timestamp the post was published, in ISO 8601 format with timezone.

is_paid · boolean

true if the post was a paid/promoted post.

reposted · boolean

true if the post is a repost of other content rather than original.

text_content · string

The text body of the post.

post_classification · string

AI-assigned classification of the post’s theme. Example values: Product & technology, Brand & occasion, Other.

author · object

Author details for the post. May be an empty object when not available.

mentions · array

Entities or accounts mentioned in the post. May be an empty array.

engagement_metrics · object

Engagement counts for the post. See Engagement Metrics Object below.

Engagement Metrics Object

total_reaction_count · integer

Total number of reactions across all reaction types.

like_count · integer

Number of “like” reactions.

empathy_count · integer

Number of “empathy” / support reactions.

praise_count · integer

Number of “praise” / celebrate reactions.

appreciation_count · integer

Number of “appreciation” reactions.

interest_count · integer

Number of “interest” reactions.

funny_count · integer

Number of “funny” reactions.

comments_count · integer

Number of comments on the post.

reposts_Count · integer

Number of times the post was reposted / shared.

200

{
  "count": 406,
  "limit": 10,
  "offset": 0,
  "data": {
    "uuid": "00000l1",
    "posts": [
      {
        "id": "WXLOA811U2",
        "content_type": "image",
        "link": "https://www.linkedin.com/feed/update/urn:li:activity:7480953969704419328/",
        "posted_date": "2026-07-09 12:00:15.781000+00:00",
        "is_paid": false,
        "reposted": false,
        "engagement_metrics": {
          "total_reaction_count": 76,
          "like_count": 65,
          "empathy_count": 8,
          "praise_count": 2,
          "appreciation_count": 0,
          "interest_count": 1,
          "funny_count": 0,
          "comments_count": 0,
          "reposts_Count": 2
        },
        "text_content": "Easy-peasy efficiency 🍋✨ Have you got a hack you want to share in the comments?",
        "post_classification": "Other",
        "author": {},
        "mentions": []
      },
      {
        "id": "WXP178134W",
        "content_type": "image",
        "link": "https://www.linkedin.com/feed/update/urn:li:activity:7477677369806479361/",
        "posted_date": "2026-06-30 11:00:13.489000+00:00",
        "is_paid": false,
        "reposted": false,
        "engagement_metrics": {
          "total_reaction_count": 1172,
          "like_count": 985,
          "empathy_count": 125,
          "praise_count": 38,
          "appreciation_count": 0,
          "interest_count": 13,
          "funny_count": 1,
          "comments_count": 0,
          "reposts_Count": 24
        },
        "text_content": "What new Canva tool do you wish we could work on next? 💬",
        "post_classification": "Product & technology",
        "author": {},
        "mentions": []
      }
    ]
  },
  "credits_consumed": 1
}

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

200

application/json

Social posts returned

data · object

count · integer

limit · integer

offset · integer

credits_consumed · number<float>