Signals

Signals First

Signals First asks any natural-language signal question and discovers up to 100 evidence-backed signals across distinct companies. Callers provide only query and limit; Signaliz owns the evidence window and source selection. Every returned signal includes its type, title, summary, company name, root domain, date, and source URL. Signals First is included on eligible plans: credits_used and credits_charged are zero when billing_status is included. Resume the returned signal_search_run_id to recover an interrupted search. A request is a ceiling, not a promise: fewer results are returned when public evidence cannot verify both a date and company identity.

post/functions/v1/api/v2/signals-first

Request

  • Base URL: https://api.signaliz.com
  • URL: https://api.signaliz.com/functions/v1/api/v2/signals-first
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional durable retry key for a signal discovery run.

Request body

OR

Response

Signal discovery completed or dry-run planned.

successboolean required
status'planned' | 'queued' | 'processing' | 'partial' | 'completed' | 'completed_with_warnings' | 'failed' required
capability'signals_everything' required
signal_search_run_idstring

Present for queued, processing, and completed searches; omitted for a no-dispatch dry run.

querystring
requested_countinteger
stagestring
progressinteger
messagestring
next_poll_after_secondsinteger
signal_countinteger required
idempotency_replayedboolean
cache_hitboolean

True when this response was served from a retained Signals First run.

live_provider_calledboolean

True only when this request called a live search provider.

result_returned_from'stored_signal_search_run'
credits_used0
credits_charged0
billing_status'included'
errorstring
error_codestring
retry_eligibleboolean
retry_after_secondsinteger

Changes

No recorded changes to this operation across all 1 revision of this API.