---
title: "Start X Activity Signals"
method: POST
path: "/api/signals/x-activity/start"
tags: ["social-activity"]
---

# Start X Activity Signals

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

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/signals/x-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

- XActivityStartRequest
  - `artifact_label` string, nullable
  - `contract_version` 'x-activity-signals.v1', required
  - `request` union, required
    - XPostSearchRequest
      - `checkpoint` SocialCheckpointRequest
        - `occurred_at` string, date-time, nullable
        - `recent_signal_ids` string[]
        - `signal_ids_at_occurred_at` string[]
      - `kind` 'post_search', required
      - `max_pages` integer
      - `max_results` integer
      - `page_size` integer
      - `query` string, required
      - `type` 'Top' | 'Latest' | 'Media'
    - XUserProfileRequest
      - `checkpoint` SocialCheckpointRequest
        - `occurred_at` string, date-time, nullable
        - `recent_signal_ids` string[]
        - `signal_ids_at_occurred_at` string[]
      - `kind` 'user_profile', required
      - `max_pages` integer
      - `max_results` integer
      - `page_size` integer
      - `username` string, required
    - XUserPostsRequest
      - `checkpoint` SocialCheckpointRequest
        - `occurred_at` string, date-time, nullable
        - `recent_signal_ids` string[]
        - `signal_ids_at_occurred_at` string[]
      - `kind` 'user_posts', required
      - `max_pages` integer
      - `max_results` integer
      - `page_size` integer
      - `user` string, required
    - XUserRepliesRequest
      - `checkpoint` SocialCheckpointRequest
        - `occurred_at` string, date-time, nullable
        - `recent_signal_ids` string[]
        - `signal_ids_at_occurred_at` string[]
      - `kind` 'user_replies', required
      - `max_pages` integer
      - `max_results` integer
      - `page_size` integer
      - `user` string, required
    - XPostCommentsRequest
      - `checkpoint` SocialCheckpointRequest
        - `occurred_at` string, date-time, nullable
        - `recent_signal_ids` string[]
        - `signal_ids_at_occurred_at` string[]
      - `kind` 'post_comments', required
      - `max_pages` integer
      - `max_results` integer
      - `page_size` integer
      - `post_id` string, required
      - `ranking` 'Relevance' | 'Recency' | 'Likes'
    - XPostQuotesRequest
      - `checkpoint` SocialCheckpointRequest
        - `occurred_at` string, date-time, nullable
        - `recent_signal_ids` string[]
        - `signal_ids_at_occurred_at` string[]
      - `kind` 'post_quotes', required
      - `max_pages` integer
      - `max_results` integer
      - `page_size` integer
      - `post_id` string, required
    - XPostRetweetersRequest
      - `checkpoint` SocialCheckpointRequest
        - `occurred_at` string, date-time, nullable
        - `recent_signal_ids` string[]
        - `signal_ids_at_occurred_at` string[]
      - `kind` 'post_retweeters', required
      - `max_pages` integer
      - `max_results` integer
      - `page_size` integer
      - `post_id` string, required

## Response `202`

Successful Response

- XActivityStartResponse
  - `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` 'x_activity_signals'
  - `rows` object[]
  - `semantic_fingerprint` string, required
  - `status` 'queued' | 'running' | 'blocked' | 'completed' | 'failed'
  - `summary` object
  - `watch_key_sha256` string, required

## 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)