Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.signalark.app/llms.txt

Use this file to discover all available pages before exploring further.

Use POST /v1/signals/ingest to push market signals into Signal Ark in batches. Signals can come from any source — funding databases, job posting scrapers, news monitors, tech stack detection tools, or your own internal systems. Signal Ark deduplicates, classifies, and ICP-scores each accepted signal automatically. Endpoint: POST https://www.signalark.app/_api/v1/signals/ingest Authentication: Authorization: Bearer sak_your_api_key_here Max batch size: 100 signals per request.

Request body

signals
object[]
required
Array of signal objects to ingest. Maximum 100 per request.

Example request

curl -X POST https://www.signalark.app/_api/v1/signals/ingest \
  -H "Authorization: Bearer sak_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "signals": [
      {
        "company_name": "Acme Corp",
        "company_domain": "acmecorp.com",
        "signal_name": "Acme Corp raises $25M Series B",
        "source": "funding",
        "description": "Acme Corp announced a $25M Series B led by Sequoia Capital, with participation from Y Combinator. The round will be used to expand enterprise sales and engineering headcount.",
        "source_url": "https://techcrunch.com/2025/04/25/acme-series-b",
        "detected_at": "2025-04-25T10:00:00Z"
      },
      {
        "company_name": "Bright Systems",
        "company_domain": "brightsystems.io",
        "signal_name": "Bright Systems hiring VP of Engineering",
        "source": "job_posting",
        "description": "Bright Systems posted a VP of Engineering role, suggesting a leadership restructuring ahead of a product expansion.",
        "source_url": "https://www.linkedin.com/jobs/view/12345",
        "detected_at": "2025-04-24T08:15:00Z"
      }
    ]
  }'

Response

A 200 response indicates the batch was received and processed. Check the stats object to see how many signals were accepted, deduplicated, or rejected.
success
boolean
true when the batch was processed without a server error, even if some individual signals were rejected or deduplicated.
batchId
string
A unique identifier for this ingestion batch. Use this ID when contacting support about a specific batch or when correlating webhook delivery events.
stats
object
Processing summary for the batch.

Example response

{
  "success": true,
  "batchId": "batch_01HZ9ABCDE",
  "stats": {
    "accepted": 2,
    "deduplicated": 0,
    "rejected": 0
  }
}

Tips for better results

Always provide company_domain. It is the primary key Signal Ark uses to match signals to accounts. Without it, Signal Ark falls back to fuzzy name matching, which is less reliable and may result in signals not being associated with the correct account.
Provide descriptive description fields. The AI pipeline uses this text to generate “Why Now” summaries and outreach angles. Short or vague descriptions produce lower-quality AI outputs.