---
title: "Start Linkedin Activity Signals"
method: POST
path: "/api/signals/linkedin-activity/start"
tags: ["linkedin"]
---

# Start Linkedin Activity Signals

`POST /api/signals/linkedin-activity/start`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/signals/linkedin-activity/start`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

## Request body

- LinkedInActivitySignalsStartRequest
  - `artifact_label` string, nullable: Optional human-readable artifact label.
  - `contract_version` 'linkedin-activity-signals.v1', required: Pinned public request contract version.
  - `request` union, required: Exactly one discriminated LinkedIn activity observation request.
    - LinkedInPostSearchSignalRequest
      - `company_urls` string[]: Optional public company-page scope for post search.
      - `kind` 'post_search', required: Search public posts by topic.
      - `max_results` integer: Global accepted-post ceiling for this artifact.
      - `order` 'date' | 'relevance', nullable: Sort newest first or by provider relevance.
      - `posted_within` 'past_24h' | 'past_week' | 'past_month', nullable: Optional provider-supported publication-time window.
      - `query` string, required: Topic or phrase that every returned public post must match.
    - LinkedInPostSignalRequest
      - `kind` 'post', required: Fetch one known public post.
      - `post` string, required: Public post URL, LinkedIn activity/share URN, or numeric activity id.
    - LinkedInPostCommentsSignalRequest
      - `kind` 'post_comments', required: Fetch comments on one known post.
      - `max_results` integer: Global accepted-comment ceiling for this artifact.
      - `post_url` string, required: Public LinkedIn post URL whose comments are requested.
      - `posted_within` 'any' | '24h' | 'week' | 'month' | '3months' | '6months' | 'year': Publication-time window for returned comments.
    - LinkedInPostReactionsSignalRequest
      - `kind` 'post_reactions', required: Fetch reactions on one known post.
      - `max_results` integer: Global accepted-reaction ceiling for this artifact.
      - `post_url` string, required: Public LinkedIn post URL whose reactions are requested.
      - `reaction_type` string, nullable: Optional provider reaction label filter; omit for all reactions.
    - LinkedInPersonCommentsSignalRequest
      - `kind` 'person_comments', required: Fetch recent comments by known people.
      - `max_results` integer: Maximum accepted comment rows per supplied profile.
      - `posted_within` 'any' | '24h' | 'week' | 'month' | '3months' | '6months' | 'year': Publication-time window for returned comments.
      - `profile_urls` string[], required: One to five public LinkedIn person profile URLs.
    - LinkedInPersonReactionsSignalRequest
      - `kind` 'person_reactions', required: Fetch recent reactions by known people.
      - `max_results` integer: Maximum accepted reaction rows per supplied profile.
      - `posted_within` 'any' | '24h' | 'week' | 'month' | '3months' | '6months' | 'year': Publication-time window for returned reactions.
      - `profile_urls` string[], required: One to five public LinkedIn person profile URLs.
    - LinkedInCompanyPostsSignalRequest
      - `company_urls` string[], required: One to five public LinkedIn company-page URLs.
      - `kind` 'company_posts', required: Fetch recent posts by known companies.
      - `max_results` integer: Maximum accepted post rows per supplied company.
      - `posted_after` string, nullable: Optional inclusive ISO-8601 publication-time lower bound.

## Response `202`

Successful Response

- LinkedInActivitySignalsStartResponse
  - `accepted_pricing` object, required
  - `artifact_id` string, required
  - `execution_contract_digest` string, required
  - `execution_id` string, required
  - `failed` boolean
  - `finished` boolean
  - `generation_id` string, required
  - `job_id` string, required
  - `operation_key` string, required
  - `phase` string
  - `progress_current` integer
  - `progress_total` integer, required
  - `request_digest` string, required
  - `result_kind` 'linkedin_activity_signals'
  - `rows` object[]
  - `semantic_fingerprint` string, required
  - `status` 'queued' | 'running' | 'blocked' | 'completed' | 'failed'
  - `summary` object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)