Market Signals

Market Signals

Market Signals let you set up automated monitoring subscriptions that continuously scan external data sources and deliver matching signals to your webhook.

Supported signal types:

Type	What it monitors
JOB_POSTS	New job postings matching title, skill, company, and location criteria
LINKEDIN_POST	LinkedIn posts matching keyword and AI-based persona/content filters (requires Sales Navigator)
FUND_RAISED	Fund closings and fundraising events (web scraping + SEC EDGAR)
RECENT_INVESTMENT	Recent investment rounds and funding announcements (web scraping + SEC EDGAR)
IPO	IPO filings and public listing announcements (web scraping + SEC EDGAR)

Typical workflow:

1. POST /v1/market-signals/subscriptions - Create a subscription with type, filters, and webhook URL

2. Subscription automatically polls on the configured interval (daily or weekly)

3. New matching signals are delivered to your webhook as batched payloads

4. GET /v1/market-signals/subscriptions/{id}/signals - Browse delivered signals

5. Use pause/resume/trigger endpoints to control the subscription lifecycle

AI-powered filter generation (JOB_POSTS):

Instead of manually defining filters, you can provide a natural language prompt and the AI will generate complete filter configurations. You can also combine a prompt with partial filters for hybrid mode, where the AI augments your filters with additional criteria inferred from the prompt.

LinkedIn integration:

LINKEDIN_POST subscriptions require a connected LinkedIn Sales Navigator account via the Saber Chrome extension. The subscription uses boolean keyword search combined with AI-based content quality and persona/company filtering to surface high-relevance posts.

List all market signal subscriptions for your organization

get

Retrieve a paginated list of market signal subscriptions. By default, deleted subscriptions are excluded. Set includeDeleted=true to include them.

Results are sorted by creation date (latest first).

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

Query parameters

limitinteger · min: 1 · max: 100Optional

Maximum number of subscriptions to return (1-100, default 20)

Default: 20

offsetintegerOptional

Number of subscriptions to skip for pagination (default 0)

Default: 0

includeDeletedbooleanOptional

Include soft-deleted subscriptions in the response

Default: false

Responses

200

Subscriptions retrieved successfully

application/json

Paginated list of market signal subscriptions

totalintegerRequired

Total number of subscriptions matching the query

Example: 5

limitintegerRequired

Maximum subscriptions per page

Example: 20

offsetintegerRequired

Number of subscriptions skipped

Example: 0

401

Unauthorized - Invalid or missing API key

application/json

500

Internal Server Error

application/json

get

/v1/market-signals/subscriptions

HTTPcURLJavaScriptPython

GET /v1/market-signals/subscriptions HTTP/1.1
Host: api.saber.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": "a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "organizationId": "org_123",
      "type": "JOB_POSTS",
      "name": "DevOps hiring tracker",
      "status": "active",
      "prompt": "Find companies hiring machine learning engineers",
      "filters": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "webhookUrl": "https://myapp.com/webhooks/market-signals",
      "intervalSignalLimit": 500,
      "interval": "daily",
      "createdAt": "2024-06-15T10:00:00Z",
      "updatedAt": "2024-06-15T10:00:00Z"
    }
  ],
  "total": 5,
  "limit": 20,
  "offset": 0
}

Create a market signal subscription to monitor job posts, LinkedIn posts, fundraising, investments, or IPOs

post

Create a subscription that continuously monitors external data sources and delivers matching signals to your webhook. Subscriptions run on a configurable polling interval (daily or weekly) and automatically detect and deliver new signals as they appear.

---

Subscription Types

Type	Description	Data Source
JOB_POSTS	Monitor new job postings matching your criteria	Job posting aggregators
LINKEDIN_POST	Monitor LinkedIn posts matching keyword filters	LinkedIn (requires Sales Navigator)
FUND_RAISED	Monitor fund closings and fundraising events	Web scraping + SEC EDGAR
RECENT_INVESTMENT	Monitor recent investment and funding rounds	Web scraping + SEC EDGAR
IPO	Monitor IPO and public listing announcements	Web scraping + SEC EDGAR

---

Filter Modes

Filters can be provided in three ways:

1. Prompt only (JOB_POSTS): Provide a natural language prompt and the AI generates complete filters

2. Prompt + filters (JOB_POSTS): Provide both; the AI augments your filters with prompt intent

3. Filters only: Provide structured filters directly (required for LINKEDIN_POST)

---

Webhook Delivery

Matched signals are batched and delivered to your webhookUrl on each polling interval. Each delivery includes an array of signal objects with metadata, payload, and confidence scores. Use webhookSecret to verify webhook signatures via HMAC-SHA256.

---

LinkedIn Post Requirements

LINKEDIN_POST subscriptions require a connected LinkedIn Sales Navigator account. If no connector is found, the request returns an error with setup instructions.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

Body

application/json

typestring · enumRequired

The type of market signal to monitor. Determines which data sources are polled and which filter schema is accepted.

Example: JOB_POSTSPossible values:

namestring · max: 200Optional

Optional display name for the subscription

Example: DevOps hiring tracker

promptstringOptional

Natural language prompt for AI-based filter generation (JOB_POSTS only). When provided without filters, the AI generates complete filters from the prompt. When provided with filters, the AI augments the filters with prompt intent. Not yet supported for LINKEDIN_POST.

Example: Find companies hiring machine learning engineers at seed to Series B startups in Europe

webhookUrlstring · uri · max: 2048Required

URL to receive webhook notifications when new signals are matched

Example: https://myapp.com/webhooks/market-signals

webhookSecretstringOptional

Optional secret for HMAC-SHA256 webhook signature verification

Example: whsec_abc123

intervalSignalLimitinteger · min: 1 · max: 10000Optional

Maximum number of signals to deliver per polling interval (1-10000, default 500)

Default: 500Example: 100

intervalstring · enumOptional

Polling interval for checking new signals

Default: dailyExample: dailyPossible values:

Responses

201

Subscription created successfully

application/json

400

Bad Request - Invalid input or missing required fields

application/json

401

Unauthorized - Invalid or missing API key

application/json

422

Unprocessable Entity - Validation error (e.g., LinkedIn connector required for LINKEDIN_POST)

application/json

429

Too Many Requests - Rate limit exceeded

application/json

500

Internal Server Error

application/json

post

/v1/market-signals/subscriptions

HTTPcURLJavaScriptPython

POST /v1/market-signals/subscriptions HTTP/1.1
Host: api.saber.app
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 321

{
  "type": "JOB_POSTS",
  "name": "DevOps hiring in US tech",
  "filters": {
    "titleKeywords": [
      "DevOps Engineer",
      "Site Reliability Engineer"
    ],
    "countries": [
      "US"
    ],
    "minEmployees": 50,
    "maxEmployees": 500,
    "excludeRecruitingAgencies": true
  },
  "webhookUrl": "https://myapp.com/webhooks/market-signals",
  "interval": "daily",
  "intervalSignalLimit": 100
}

Monitor DevOps job postings in the USGenerate filters from natural language promptMonitor LinkedIn posts about AIMonitor fund closingsMonitor Series B+ funding roundsMonitor IPO announcements

{
  "id": "a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "organizationId": "org_123",
  "type": "JOB_POSTS",
  "name": "AI/ML hiring startups",
  "status": "active",
  "prompt": "Find companies hiring machine learning engineers at seed to Series B startups in Europe",
  "filters": {
    "type": "JOB_POSTS",
    "titleKeywords": [
      "Machine Learning Engineer",
      "ML Engineer",
      "AI Engineer"
    ],
    "countries": [
      "DE",
      "FR",
      "GB",
      "NL",
      "SE"
    ],
    "fundingStages": [
      "seed",
      "series_a",
      "series_b"
    ]
  },
  "webhookUrl": "https://myapp.com/webhooks/market-signals",
  "intervalSignalLimit": 500,
  "interval": "daily",
  "createdAt": "2024-06-15T10:00:00Z",
  "updatedAt": "2024-06-15T10:00:00Z"
}

Get a market signal subscription by ID

get

Retrieve a single market signal subscription including its filter configuration and status.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

Path parameters

subscriptionIdstring · uuidRequired

The unique identifier of the subscription

Example: a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d

Responses

200

Subscription retrieved successfully

application/json

A market signal subscription with its current configuration and status

idstring · uuidRequired

Unique identifier for the subscription

Example: a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d

organizationIdstringRequired

Organization that owns this subscription

Example: org_123

typestring · enumRequired

The subscription type (immutable after creation)

Example: JOB_POSTSPossible values:

namestring · nullableOptional

Display name for the subscription

Example: DevOps hiring tracker

statusstring · enumRequired

Current subscription status (derived from timestamps)

Example: activePossible values:

promptstring · nullableOptional

Natural language prompt used for filter generation (if applicable)

Example: Find companies hiring machine learning engineers

webhookUrlstring · uriRequired

Webhook delivery URL

Example: https://myapp.com/webhooks/market-signals

intervalSignalLimitintegerRequired

Maximum signals per polling interval

Example: 500

intervalstring · enumRequired

Polling interval

Example: dailyPossible values:

createdAtstring · date-timeRequired

When the subscription was created

Example: 2024-06-15T10:00:00Z

updatedAtstring · date-timeRequired

When the subscription was last updated

Example: 2024-06-15T10:00:00Z

401

Unauthorized - Invalid or missing API key

application/json

404

Subscription not found

application/json

500

Internal Server Error

application/json

get

/v1/market-signals/subscriptions/{subscriptionId}

HTTPcURLJavaScriptPython

GET /v1/market-signals/subscriptions/{subscriptionId} HTTP/1.1
Host: api.saber.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "organizationId": "org_123",
  "type": "JOB_POSTS",
  "name": "DevOps hiring tracker",
  "status": "active",
  "prompt": "Find companies hiring machine learning engineers",
  "filters": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "webhookUrl": "https://myapp.com/webhooks/market-signals",
  "intervalSignalLimit": 500,
  "interval": "daily",
  "createdAt": "2024-06-15T10:00:00Z",
  "updatedAt": "2024-06-15T10:00:00Z"
}

Delete a market signal subscription

delete

Soft-delete a subscription and stop its polling workflow. The subscription will no longer deliver signals. This operation cannot be undone via the API.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

Path parameters

subscriptionIdstring · uuidRequired

The unique identifier of the subscription to delete

Example: a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d

Responses

204

Subscription deleted successfully

401

Unauthorized - Invalid or missing API key

application/json

404

Subscription not found

application/json

500

Internal Server Error

application/json

delete

/v1/market-signals/subscriptions/{subscriptionId}

HTTPcURLJavaScriptPython

DELETE /v1/market-signals/subscriptions/{subscriptionId} HTTP/1.1
Host: api.saber.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Update a market signal subscription

patch

Partially update a subscription's configuration. All fields are optional; only provided fields are updated. The subscription type is immutable and cannot be changed after creation.

When filters or webhook configuration changes, the active polling workflow is automatically refreshed. When the polling interval changes, the workflow is recreated.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

Path parameters

subscriptionIdstring · uuidRequired

The unique identifier of the subscription to update

Example: a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d

Body

application/json

Partial update for a market signal subscription. All fields are optional; only provided fields are updated. The subscription type is immutable and cannot be changed.

namestring · max: 200Optional

Updated display name

Example: Updated DevOps tracker

promptstringOptional

Updated natural language prompt (JOB_POSTS only)

webhookUrlstring · uri · max: 2048Optional

Updated webhook URL

webhookSecretstringOptional

Updated webhook secret

intervalSignalLimitinteger · min: 1 · max: 10000Optional

Updated maximum signals per interval (1-10000)

intervalstring · enumOptional

Updated polling interval. Changing this recreates the polling workflow.

Possible values:

Responses

200

Subscription updated successfully

application/json

A market signal subscription with its current configuration and status

idstring · uuidRequired

Unique identifier for the subscription

Example: a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d

organizationIdstringRequired

Organization that owns this subscription

Example: org_123

typestring · enumRequired

The subscription type (immutable after creation)

Example: JOB_POSTSPossible values:

namestring · nullableOptional

Display name for the subscription

Example: DevOps hiring tracker

statusstring · enumRequired

Current subscription status (derived from timestamps)

Example: activePossible values:

promptstring · nullableOptional

Natural language prompt used for filter generation (if applicable)

Example: Find companies hiring machine learning engineers

webhookUrlstring · uriRequired

Webhook delivery URL

Example: https://myapp.com/webhooks/market-signals

intervalSignalLimitintegerRequired

Maximum signals per polling interval

Example: 500

intervalstring · enumRequired

Polling interval

Example: dailyPossible values:

createdAtstring · date-timeRequired

When the subscription was created

Example: 2024-06-15T10:00:00Z

updatedAtstring · date-timeRequired

When the subscription was last updated

Example: 2024-06-15T10:00:00Z

400

Bad Request - Malformed request body

application/json

401

Unauthorized - Invalid or missing API key

application/json

404

Subscription not found

application/json

422

Unprocessable Entity - Validation error (e.g., invalid webhookUrl or out-of-range intervalSignalLimit)

application/json

500

Internal Server Error

application/json

patch

/v1/market-signals/subscriptions/{subscriptionId}

HTTPcURLJavaScriptPython

PATCH /v1/market-signals/subscriptions/{subscriptionId} HTTP/1.1
Host: api.saber.app
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 93

{
  "filters": {
    "titleKeywords": [
      "DevOps Engineer",
      "Platform Engineer"
    ],
    "countries": [
      "US",
      "GB"
    ]
  }
}

Update subscription filtersChange polling interval to weeklyUpdate webhook URL

{
  "id": "a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "organizationId": "org_123",
  "type": "JOB_POSTS",
  "name": "DevOps hiring tracker",
  "status": "active",
  "prompt": "Find companies hiring machine learning engineers",
  "filters": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "webhookUrl": "https://myapp.com/webhooks/market-signals",
  "intervalSignalLimit": 500,
  "interval": "daily",
  "createdAt": "2024-06-15T10:00:00Z",
  "updatedAt": "2024-06-15T10:00:00Z"
}

Pause a market signal subscription

post

Pause an active subscription. The polling workflow is suspended and no new signals will be delivered until the subscription is resumed. The subscription configuration is preserved.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

Path parameters

subscriptionIdstring · uuidRequired

The unique identifier of the subscription to pause

Example: a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d

Responses

200

Subscription paused successfully

application/json

A market signal subscription with its current configuration and status

idstring · uuidRequired

Unique identifier for the subscription

Example: a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d

organizationIdstringRequired

Organization that owns this subscription

Example: org_123

typestring · enumRequired

The subscription type (immutable after creation)

Example: JOB_POSTSPossible values:

namestring · nullableOptional

Display name for the subscription

Example: DevOps hiring tracker

statusstring · enumRequired

Current subscription status (derived from timestamps)

Example: activePossible values:

promptstring · nullableOptional

Natural language prompt used for filter generation (if applicable)

Example: Find companies hiring machine learning engineers

webhookUrlstring · uriRequired

Webhook delivery URL

Example: https://myapp.com/webhooks/market-signals

intervalSignalLimitintegerRequired

Maximum signals per polling interval

Example: 500

intervalstring · enumRequired

Polling interval

Example: dailyPossible values:

createdAtstring · date-timeRequired

When the subscription was created

Example: 2024-06-15T10:00:00Z

updatedAtstring · date-timeRequired

When the subscription was last updated

Example: 2024-06-15T10:00:00Z

401

Unauthorized - Invalid or missing API key

application/json

404

Subscription not found or already paused/deleted

application/json

500

Internal Server Error

application/json

post

/v1/market-signals/subscriptions/{subscriptionId}/pause

HTTPcURLJavaScriptPython

POST /v1/market-signals/subscriptions/{subscriptionId}/pause HTTP/1.1
Host: api.saber.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "organizationId": "org_123",
  "type": "JOB_POSTS",
  "name": "DevOps hiring tracker",
  "status": "active",
  "prompt": "Find companies hiring machine learning engineers",
  "filters": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "webhookUrl": "https://myapp.com/webhooks/market-signals",
  "intervalSignalLimit": 500,
  "interval": "daily",
  "createdAt": "2024-06-15T10:00:00Z",
  "updatedAt": "2024-06-15T10:00:00Z"
}

Resume a paused market signal subscription

post

Resume a paused subscription. The polling workflow restarts and signals will be delivered again on the next interval.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

Path parameters

subscriptionIdstring · uuidRequired

The unique identifier of the subscription to resume

Example: a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d

Responses

200

Subscription resumed successfully

application/json

A market signal subscription with its current configuration and status

idstring · uuidRequired

Unique identifier for the subscription

Example: a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d

organizationIdstringRequired

Organization that owns this subscription

Example: org_123

typestring · enumRequired

The subscription type (immutable after creation)

Example: JOB_POSTSPossible values:

namestring · nullableOptional

Display name for the subscription

Example: DevOps hiring tracker

statusstring · enumRequired

Current subscription status (derived from timestamps)

Example: activePossible values:

promptstring · nullableOptional

Natural language prompt used for filter generation (if applicable)

Example: Find companies hiring machine learning engineers

webhookUrlstring · uriRequired

Webhook delivery URL

Example: https://myapp.com/webhooks/market-signals

intervalSignalLimitintegerRequired

Maximum signals per polling interval

Example: 500

intervalstring · enumRequired

Polling interval

Example: dailyPossible values:

createdAtstring · date-timeRequired

When the subscription was created

Example: 2024-06-15T10:00:00Z

updatedAtstring · date-timeRequired

When the subscription was last updated

Example: 2024-06-15T10:00:00Z

401

Unauthorized - Invalid or missing API key

application/json

404

Subscription not found or not paused

application/json

500

Internal Server Error

application/json

post

/v1/market-signals/subscriptions/{subscriptionId}/resume

HTTPcURLJavaScriptPython

POST /v1/market-signals/subscriptions/{subscriptionId}/resume HTTP/1.1
Host: api.saber.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "organizationId": "org_123",
  "type": "JOB_POSTS",
  "name": "DevOps hiring tracker",
  "status": "active",
  "prompt": "Find companies hiring machine learning engineers",
  "filters": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "webhookUrl": "https://myapp.com/webhooks/market-signals",
  "intervalSignalLimit": 500,
  "interval": "daily",
  "createdAt": "2024-06-15T10:00:00Z",
  "updatedAt": "2024-06-15T10:00:00Z"
}

Trigger an immediate run of a market signal subscription

post

Trigger an immediate polling run for the subscription, regardless of the normal interval schedule. This is useful for testing a new subscription or forcing a refresh after updating filters.

The request succeeds regardless of the subscription's status. However, only subscriptions in active status will execute the polling workflow and deliver signals. Paused or deleted subscriptions return 200 but do not trigger a run.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

Path parameters

subscriptionIdstring · uuidRequired

The unique identifier of the subscription to trigger

Example: a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d

Responses

200

Subscription triggered successfully

application/json

A market signal subscription with its current configuration and status

idstring · uuidRequired

Unique identifier for the subscription

Example: a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d

organizationIdstringRequired

Organization that owns this subscription

Example: org_123

typestring · enumRequired

The subscription type (immutable after creation)

Example: JOB_POSTSPossible values:

namestring · nullableOptional

Display name for the subscription

Example: DevOps hiring tracker

statusstring · enumRequired

Current subscription status (derived from timestamps)

Example: activePossible values:

promptstring · nullableOptional

Natural language prompt used for filter generation (if applicable)

Example: Find companies hiring machine learning engineers

webhookUrlstring · uriRequired

Webhook delivery URL

Example: https://myapp.com/webhooks/market-signals

intervalSignalLimitintegerRequired

Maximum signals per polling interval

Example: 500

intervalstring · enumRequired

Polling interval

Example: dailyPossible values:

createdAtstring · date-timeRequired

When the subscription was created

Example: 2024-06-15T10:00:00Z

updatedAtstring · date-timeRequired

When the subscription was last updated

Example: 2024-06-15T10:00:00Z

401

Unauthorized - Invalid or missing API key

application/json

404

Subscription not found

application/json

500

Internal Server Error

application/json

post

/v1/market-signals/subscriptions/{subscriptionId}/trigger

HTTPcURLJavaScriptPython

POST /v1/market-signals/subscriptions/{subscriptionId}/trigger HTTP/1.1
Host: api.saber.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "organizationId": "org_123",
  "type": "JOB_POSTS",
  "name": "DevOps hiring tracker",
  "status": "active",
  "prompt": "Find companies hiring machine learning engineers",
  "filters": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "webhookUrl": "https://myapp.com/webhooks/market-signals",
  "intervalSignalLimit": 500,
  "interval": "daily",
  "createdAt": "2024-06-15T10:00:00Z",
  "updatedAt": "2024-06-15T10:00:00Z"
}

List signals delivered by a market signal subscription

get

Retrieve a paginated list of signals that have been matched and stored by a subscription. Each signal includes the raw payload from the data source (e.g., job posting details, LinkedIn post content, or funding announcement), along with metadata like confidence scores and delivery status.

Results are sorted by creation date (latest first).

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

Path parameters

subscriptionIdstring · uuidRequired

The unique identifier of the subscription

Example: a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d

Query parameters

limitinteger · min: 1 · max: 100Optional

Maximum number of signals to return (1-100, default 20)

Default: 20

offsetintegerOptional

Number of signals to skip for pagination (default 0)

Default: 0

Responses

200

Signals retrieved successfully

application/json

Paginated list of market signals for a subscription

totalintegerRequired

Total number of signals for the subscription

Example: 42

limitintegerRequired

Maximum signals per page

Example: 20

offsetintegerRequired

Number of signals skipped

Example: 0

401

Unauthorized - Invalid or missing API key

application/json

404

Subscription not found

application/json

500

Internal Server Error

application/json

get

/v1/market-signals/subscriptions/{subscriptionId}/signals

HTTPcURLJavaScriptPython

GET /v1/market-signals/subscriptions/{subscriptionId}/signals HTTP/1.1
Host: api.saber.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": "sig_001",
      "subscriptionId": "a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "jobPostingId": "jp_123",
      "externalSignalId": null,
      "payload": {
        "title": "Senior DevOps Engineer",
        "company": "Acme Corp",
        "location": "San Francisco, CA",
        "url": "https://jobs.acme.com/devops"
      },
      "confidenceScore": 0.92,
      "status": "delivered",
      "publishedAt": "2024-06-14T08:00:00Z",
      "createdAt": "2024-06-15T10:30:00Z",
      "deliveredAt": "2024-06-15T10:31:00Z"
    },
    {
      "id": "sig_002",
      "subscriptionId": "a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "jobPostingId": null,
      "externalSignalId": "li_post_456",
      "payload": {
        "text": "Excited to announce our Series B funding...",
        "author": {
          "name": "Jane CEO",
          "headline": "CEO at TechStartup"
        }
      },
      "confidenceScore": 0.87,
      "status": "pending",
      "publishedAt": "2024-06-15T09:00:00Z",
      "createdAt": "2024-06-15T10:30:00Z",
      "deliveredAt": null
    }
  ],
  "total": 42,
  "limit": 20,
  "offset": 0
}