Skip to main content
GET
/
posts
curl "https://api.joinoverlap.com/posts?companyId=YOUR_COMPANY_ID&sortBy=views&limit=25" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch(
  'https://api.joinoverlap.com/posts?companyId=YOUR_COMPANY_ID&sortBy=views&limit=25',
  { headers: { Authorization: 'Bearer YOUR_API_KEY' } }
);
const { posts, cursor } = await response.json();

import requests

response = requests.get(
    "https://api.joinoverlap.com/posts",
    params={"companyId": "YOUR_COMPANY_ID", "sortBy": "views", "limit": 25},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
posts = response.json()["posts"]

​
Endpoint

GET https://api.joinoverlap.com/posts?companyId={companyId}
Lists posts that Overlap has published to social platforms for your company, newest first, including each post’s rolled-up analytics counters. Use it to discover postIds for GET /post-analytics, or to find every post published from a specific clip via the clipId filter.

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Query Parameters

ParameterRequiredDescription
companyIdYesYour Overlap company or organization identifier.
clipIdNoReturn only the posts published from this clip (the clip id from GET /workflow-results/{triggerId}). Returns all matches in one response — sortBy and cursor are ignored on this path.
platformNoFilter by platform (youtube, tiktok, instagram, twitter, linkedin, facebook, threads, snapchat, bluesky). Applied per page, so a filtered page may contain fewer than limit items — keep paging until cursor is null.
sortByNodate (default), views, likes, or comments. Metric sorts order by the post’s current rollup, descending.
startDate / endDateNoISO-8601 date or datetime bounds on the post’s publish time. Only valid with sortBy=date.
limitNoPage size, 1–100. Defaults to 25.
cursorNoPagination cursor from the previous response.
The same listing is also available at GET /companies/{companyId}/posts.
curl "https://api.joinoverlap.com/posts?companyId=YOUR_COMPANY_ID&sortBy=views&limit=25" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch(
  'https://api.joinoverlap.com/posts?companyId=YOUR_COMPANY_ID&sortBy=views&limit=25',
  { headers: { Authorization: 'Bearer YOUR_API_KEY' } }
);
const { posts, cursor } = await response.json();

import requests

response = requests.get(
    "https://api.joinoverlap.com/posts",
    params={"companyId": "YOUR_COMPANY_ID", "sortBy": "views", "limit": 25},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
posts = response.json()["posts"]

​
Response

Returns an array of Post objects and a pagination cursor. cursor is null when there are no more pages; otherwise pass it back as the cursor query parameter. 
{
  "posts": [
    {
      "id": "uV9LKKuVU2IiRcwv7UvY",
      "platform": "youtube",
      "text": "Top agent Jarred Arfa and promoter Danny Hayes say fans finally figured out the game...",
      "postUrl": "https://youtu.be/3j6-UUMa6WE",
      "nativeId": "3j6-UUMa6WE",
      "clipId": "6dd94ba0-908c-4489-897f-4bc02fe96650",
      "status": "success",
      "mediaUrl": "https://.../exported-6dd94ba0.mp4",
      "thumbnailUrl": "https://.../thumb.jpg",
      "createdAt": "2026-07-10T19:31:30+00:00",
      "analytics": { "views": 969, "likes": 9, "comments": 0, "shares": 0 },
      "engagementScore": 27.69,
      "growthRate": 9.1,
      "lastAnalyticsUpdate": "2026-07-10T23:10:31+00:00"
    }
  ],
  "cursor": "uV9LKKuVU2IiRcwv7UvY"
}

Post Analytics

All current analytics for a single post.

Analytics Model

Field-by-field response reference.