ACTION_ID: get_company_or_person_linkedin_posts
NAME: LinkedIn: Scrape Posts
CATEGORY: enrich
CREDITS: 2 (per 20 posts)

Scrape recent LinkedIn posts from a person or company profile.
Returns a structured array of post records — each with the post
URL, body copy, engagement counts (reactions and comments), and
publish date — plus a count of posts found. Use it to reference
a prospect's recent posts in outreach copy, get additional context on a company, or to filter and
score prospects based on what they've been posting about.

INDEX:
  1. Inputs
  2. Outputs
  3. How to configure
  4. Key notes
  5. Where it fits in a workflow
  6. When to use
  7. When not to use

================================================================================
1. INPUTS
================================================================================

linkedin_url (type: url, required) — LinkedIn URL
  URL of the person or company LinkedIn profile to scrape posts
  from. Must be a flagship LinkedIn URL.

================================================================================
2. OUTPUTS
================================================================================

linkedin_posts (type: structured_array) — LinkedIn Posts
  Posts found on the profile, with one entry per post. Per-row
  fields:
  - url (type: string) — URL
      URL of the post.
  - post (type: string) — Post
      Post body / commentary text.
  - total_comments (type: string) — Total Comments
      Total comment count on the post.
  - total_reactions (type: string) — Total Reactions
      Total reaction count on the post.
  - date (type: string) — Date
      Publish date.
  - time (type: string) — Time
      Publish time.

number_of_posts (type: number) — Number of Posts
  Total number of posts returned in the posts array.

================================================================================
3. HOW TO CONFIGURE
================================================================================

Configure Action body:

{
  "inputs": {
    "linkedin_url": "{{input.linkedin_url}}"
  }
}

Pass a flagship person or company LinkedIn URL as `linkedin_url`.

================================================================================
4. KEY NOTES
================================================================================

- The input must be a flagship LinkedIn URL
  (`linkedin.com/in/<handle>` for a person,
  `linkedin.com/company/<handle>` for a company). Sales Nav opaque
  IDs are not supported — convert via `enrich_person_linkedin_profile`
  first.
- `linkedin_posts` is a structured_array — reference one column at a
  time via `{{<this_action>.linkedin_posts.<column>}}` (e.g.
  `linkedin_posts.post`, `linkedin_posts.total_reactions`), or fan
  out into individual rows with `push_data_to_sheet`.

================================================================================
5. WHERE IT FITS IN A WORKFLOW
================================================================================

Pattern: prospect linkedin_url -> get_company_or_person_linkedin_posts ->
llm_models (write personalized opener referencing recent posts) ->
outreach.

================================================================================
6. WHEN TO USE
================================================================================

Use get_company_or_person_linkedin_posts to pull a prospect or
target company's recent LinkedIn posts — to reference them in
outreach copy, get additional context on a company, or to filter and score prospects based on what
they're posting about.

================================================================================
7. WHEN NOT TO USE
================================================================================

Need engagers (reactors/commenters) of a specific post
  -> get_linkedin_post_reactors
     (https://floqer.com/docs/action-detail/get_linkedin_post_reactors.txt)

Need profile or company-page metadata, not posts
  -> enrich_person_linkedin_profile or enrich_company_linkedin_profile
     (https://floqer.com/docs/action-detail/<action_id>.txt)

================================================================================

This file is maintained manually. Last updated: 2026-04-30.
Full interactive reference: https://floqer.com/docs/reference
Action catalog: https://floqer.com/docs/action-catalog.txt