API Documentation

Everything you need to integrate the RichAPI API into your product.

Posts

LinkedIn Company Posts

Get recent posts published by a LinkedIn company. Supports filtering by date recency and cursor-based pagination.

POST
/api/v1/company_posts

Parameters

FieldTypeRequiredDescription
companystringNoLinkedIn company URL (use this, companyId, or companyUniversalName)
companyIdstringNoLinkedIn company numeric ID (fastest lookup)
companyUniversalNamestringNoLast path segment of the company LinkedIn URL (e.g. texauhq)
postedLimitstringNoPre-filter posts by recency: 24h, week, or month (applied on LinkedIn side)
scrapePostedLimitstringNoPost-filter posts by recency after scraping: 1h, 24h, week, month, 3months, 6months, or year
pageintegerNoPage number for pagination (1-based, default 1)
paginationTokenstringNoCursor token returned by the previous page response (required for pages > 1 on most queries)

Response fields

FieldTypeDescription
elementsarrayList of company posts (billed at 0.2 credit per element)
elements[].idstringPost ID
elements[].linkedinUrlstringLinkedIn post URL
elements[].contentstringPost text content
elements[].authorobjectAuthor info (id, name, type, linkedinUrl, avatar)
elements[].postedAtobjectPost timestamp (timestamp ms, ISO date, postedAgoText)
elements[].postImagesarrayAttached images (url, width, height)
elements[].postVideoobjectAttached video (thumbnailUrl, videoUrl) — null if no video
elements[].documentobjectAttached document/carousel (title, coverPages, totalPageCount) — null if none
elements[].pollobjectPoll data (question, options, totalVotes, closed) — null if no poll
elements[].engagementobjectEngagement stats: likes, comments, shares, reactions[]
paginationobjectPagination info including paginationToken for next page
statusstringHTTP status from upstream provider

Code

curl -X POST https://api.richapi.ai/api/v1/company_posts \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "page": 1,
  "company": "https://www.linkedin.com/company/texauhq/"
}'

Try it

Sign in to test this endpoint with your API key.

Sign in to try