Skip to main content
POST
/
v1
/
signals
/
ingest
Ingest Market Signals
curl --request POST \
  --url https://www.signalark.app/_api/v1/signals/ingest \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "signals": [
    {
      "company_name": "<string>",
      "signal_name": "<string>",
      "company_domain": "<string>",
      "description": "<string>",
      "source_url": "<string>",
      "detected_at": "2023-11-07T05:31:56Z"
    }
  ]
}
'
{
  "success": true,
  "batchId": "<string>",
  "stats": {
    "accepted": 123,
    "deduplicated": 123,
    "rejected": 123
  }
}
Use this endpoint to push batch market signals (news, funding, jobs, tech stack changes) into SignalArk.

​
Request Body

Provide an array of ExternalSignal objects under the signals key. Max 100 signals per batch. Required Fields per Signal:
  • company_name (string)
  • company_domain (string) - Critical for account matching.
  • signal_title (string)
  • signal_source (enum: funding, job_posting, linkedin, news, review_site, tech_install, twitter, web_visit, other)
Optional Fields:
  • detected_at (ISO 8601 Date)
  • signal_family (string) - Recommended for accurate classification.
  • description / notes (string)
  • Firmographic hints: industry, funding_amount, employee_count, location
  • hotness_score (number)

​
Response

The response includes processing statistics, letting you know how many signals were accepted, how many were deduplicated, and how many failed validation.

Authorizations

​
Authorization
string
header
required

Use format Bearer sak_your_api_key_here

Body

application/json
​
signals
object[]
required

Response

200 - application/json

Ingestion successful

​
success
boolean
​
batchId
string
​
stats
object