V0
Search
HAS_MCP_EQUIVALENT

List Wire

Return the most recent wire items that match the given filters.

post/v0/search/list_wire

Request

  • Base URL: https://api.ultralayer.ai
  • URL: https://api.ultralayer.ai/v0/search/list_wire
  • Auth: HTTP bearer

Request body

start_timestampstring date-time nullable

System timestamp; Inclusive ISO 8601

end_timestampstring date-time nullable

System timestamp; Inclusive ISO 8601; null=realtime

max_recordsinteger
noveltystring[] nullable

Match any.

content_typestring[] nullable

Match any.

recencystring[] nullable

Match any.

source_relationshipstring[] nullable

Match any.

factualitystring[] nullable

Match any.

categoriesstring[] nullable

Match any.

entitiesstring[] nullable

Match any.

entity_relevancestring[] nullable

Match any.

min_entity_sentimentnumber nullable

+-.2 neutral; +-.2-.6 mod; +-.6+ strong; both: >=min OR <=max

max_entity_sentimentnumber nullable
sectorsstring[] nullable

Match any.

industriesstring[] nullable

Match any.

countriesstring[] nullable

Match any; lowercase ISO 3166-1 alpha-2

asset_classesstring[] nullable

Match any.

publisherstring[] nullable

Match any.

min_importance_scorenumber nullable

0-.2 noise; .2-.4 low; .4-.6 mod; .6-.8 high; .8-1 critical

min_trustworthiness_scorenumber nullable

<.2 anon; .4-.6 mod; .6+ reputable; .8+ official

detail'full' | 'standard' | 'essential'

essential:minimal; standard:citable; full:all.

Example request

{
  "categories": [
    "earnings"
  ],
  "entities": [
    "Apple Inc.",
    "TSLA"
  ],
  "industries": [
    "automobiles"
  ],
  "countries": [
    "us"
  ],
  "publisher": [
    "reuters"
  ]
}

Response

Wire items at detail=full.

wire_idinteger required

Primary key of the wire row.

timestampstring date-time required

Canonical system time when this item was put on the wire.

source_timestampstring date-time required

Source last-update time.

headlinestring required

Ultralayer-generated headline.

publisherstring nullable required

Normalized publisher/source label, when known.

urlstring required

Link to the original item.

content_type'news' | 'analysis' | 'opinion' | 'press_release' | 'data_release' required

Kind of item.

categoriesstring[] required

Multi-label event/theme tags.

recency'realtime' | 'report_of_past' | 'report_of_future' required

Whether the item is about now, the past, or the future.

source_relationship'first_party' | 'reporting' | 'second_hand' required

How close the source is to the information.

factuality'confirmed' | 'reported' | 'rumor' | 'speculation' | 'forecast' required

Epistemic status of the item's core claim.

novelty'new' | 'update' | 'duplicate' | 'correction' required

Story-lifecycle label relative to prior wire items.

prior_wire_idinteger nullable required

Matched earlier wire item for update|duplicate|correction; null for new.

trustworthiness_scorenumber required

0..1 source credibility score.

importance_scorenumber required

0..1 market-importance score.

Changes

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