Docs · methods
Social posts
Posts scraped from tracked accounts and competitor domains, per platform. All three methods share one shape; scope by competitorId, by a tracked account url, or read everything.
get_linkedin_posts · get_twitter_posts · get_instagram_posts
01
Get LinkedIn posts
get_linkedin_postsreadLinkedIn posts stored for a project, newest first. Scope with competitorId or a tracked account url from list_tracked_accounts; omit both to read every account and competitor domain on the platform.
Parameters7
- projectIdintegerRequiredProject id from list_projects. Every scoped method needs it.
- competitorIdintegerOptionalCompetitor id from list_competitors. Omit to cover every tracked competitor in the project.
- urlstringOptionalTracked account url from list_tracked_accounts.
- fromISO dateOptionalOnly items published on or after this date, e.g. 2026-08-01.
- toISO dateOptionalOnly items published on or before this date.
- limitintegerOptionalRows to return. Defaults to 20, clamped to 100.
- cursorstringOptionalnextCursor from the previous page of this same method.
Returns5
- items[]postcontent, sourceUrl, publishedAt, author, engagement (likes, comments, shares, views), mediaUrls, accountUrl.
- resolvedAccounts[]accountThe accounts the read actually covered: url, displayName, lastPortedAt.
- emptyReasonstring | nullWhy a result is empty when it is: nothing tracked vs nothing collected yet.
- nextCursorstring | nullPass back as cursor to read the next page. Null when done.
- hasMoreboolean
02
Get X (Twitter) posts
get_twitter_postsreadSame shape and scoping as get_linkedin_posts, for X.
Parameters7
- projectIdintegerRequiredProject id from list_projects. Every scoped method needs it.
- competitorIdintegerOptionalCompetitor id from list_competitors. Omit to cover every tracked competitor in the project.
- urlstringOptionalTracked account url from list_tracked_accounts.
- fromISO dateOptionalOnly items published on or after this date, e.g. 2026-08-01.
- toISO dateOptionalOnly items published on or before this date.
- limitintegerOptionalRows to return. Defaults to 20, clamped to 100.
- cursorstringOptionalnextCursor from the previous page of this same method.
Returns5
- items[]postcontent, sourceUrl, publishedAt, author, engagement (likes, comments, shares, views), mediaUrls, accountUrl.
- resolvedAccounts[]accountThe accounts the read actually covered: url, displayName, lastPortedAt.
- emptyReasonstring | nullWhy a result is empty when it is: nothing tracked vs nothing collected yet.
- nextCursorstring | nullPass back as cursor to read the next page. Null when done.
- hasMoreboolean
03
Get Instagram posts
get_instagram_postsreadSame shape and scoping as get_linkedin_posts, for Instagram.
Parameters7
- projectIdintegerRequiredProject id from list_projects. Every scoped method needs it.
- competitorIdintegerOptionalCompetitor id from list_competitors. Omit to cover every tracked competitor in the project.
- urlstringOptionalTracked account url from list_tracked_accounts.
- fromISO dateOptionalOnly items published on or after this date, e.g. 2026-08-01.
- toISO dateOptionalOnly items published on or before this date.
- limitintegerOptionalRows to return. Defaults to 20, clamped to 100.
- cursorstringOptionalnextCursor from the previous page of this same method.
Returns5
- items[]postcontent, sourceUrl, publishedAt, author, engagement (likes, comments, shares, views), mediaUrls, accountUrl.
- resolvedAccounts[]accountThe accounts the read actually covered: url, displayName, lastPortedAt.
- emptyReasonstring | nullWhy a result is empty when it is: nothing tracked vs nothing collected yet.
- nextCursorstring | nullPass back as cursor to read the next page. Null when done.
- hasMoreboolean