Signals

Synthesized conclusions derived from Events

Find synthesized Signals

GET

https://api.cafecito.tech

/espresso/signals

Use when the user asks what a set of developments means, what impact is expected, or what broader conclusion Espresso has produced. Returns synthesized Signals, not raw observations or article content. Carry a selected data[].id into Signal detail, then list supporting Events when the conclusion needs substantiation. Search Events instead when the user needs a concrete development rather than an interpretation. from and to bound Signal created_at; tags are fuzzy text matches, while impact levels and impacted domains are exact normalized values.

Find synthesized Signals › query Parameters

q

string · maxLength: 1024

Optional natural-language semantic query. Max 1024 characters.

score_threshold

number · min: 0 · max: 1

Minimum semantic similarity threshold for q. 0.0 is broad and 1.0 is strict. Default 0.5.

Default: 0.5

from

string · date

Inclusive Signal created_at lower bound (YYYY-MM-DD).

to

string · date

Inclusive Signal created_at upper bound (YYYY-MM-DD).

ids

string[] · style: form

Restrict to Signal UUIDs (CSV).

impact_levels

string[] · style: form

Exact impact-level names (CSV), for example high,medium.

impacted_domains

string[] · style: form

Exact impacted-domain names in snake_case (CSV), for example public_health,climate.

tags

string[] · style: form

Fuzzy text match against persisted Signal tag labels (CSV).

response_type

string · enum

Response serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients. JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.

Enum values:

json

yaml

toon

Default: json

limit

integer · min: 1 · max: 100

Maximum records per page. Default 20, max 100.

Default: 20

cursor

string

Opaque continuation token. Send pagination.next_cursor from a previous response unchanged as cursor; never construct or decode it.

Find synthesized Signals › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Find synthesized Signals › Responses

Signal collection envelope

SignalCollectionResponse

SignalDocument[] · required

ResponseMeta · required

Pagination · required

Collection pagination. Send next_cursor unchanged as the next request cursor. The response does not include a cursor echo field.

GET/espresso/signals

curl https://api.cafecito.tech/espresso/signals \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "categories": [
        "media_and_journalism",
        "artificial_intelligence_and_machine_learning",
        "generative_ai_and_foundation_models"
      ],
      "companies": [
        "dubai_university",
        "spotify",
        "qatar_university"
      ],
      "confidence": "high",
      "created_at": "2026-08-23T22:00:43-04:00",
      "drivers": [
        "Governing bodies implement structured AI policies",
        "Private firms leverage AI for competitive advantage"
      ],
      "future_outlook": "Continued acceleration of AI-integrated economic activity across North Africa and Southern Europe",
      "id": "72f16578-f9b3-5921-b595-90977d00493d",
      "impact_level": "high",
      "impacted_domains": [
        "technology",
        "food_safety",
        "financial_services",
        "algorithmic_governance"
      ],
      "impacts": [
        "Trade increases via efficient logistics",
        "Environment protects from algal blooms",
        "Capital inflow fuels AI ventures",
        "Data quality rises with fraud prevention"
      ],
      "key_points": [
        "2026-07-25 UAE launches AI policy training program",
        "2026-07-25 Morocco deploys AI drones to control toxic algae",
        "2026-07-25 Saudi AI startups achieve 5x revenue over traditional rivals",
        "2026-07-25 SDAIA publishes AI bias mapping guide for 100+ types"
      ],
      "kind": "signal",
      "people": [
        "anghami",
        "carrington_malin",
        "muhammad_khalid",
        "deezer",
        "daniel_valle",
        "dubai_chambers"
      ],
      "regions": [
        "oman",
        "casablanca",
        "egypt",
        "saudi_arabia",
        "morocco",
        "japan",
        "riyadh",
        "abu_dhabi"
      ],
      "summary": "Multiple high‑impact AI initiatives unfolded concurrently in late July 2026, including UAE policy formation, Moroccan agricultural monitoring, Saudi startup success stories, and Saudi agency standardisation. Drivers included proactive regulatory action and entrepreneurial responsiveness driving tangible returns, safety improvements and confidence building.",
      "tags": [
        "oman",
        "riyadh",
        "abu_dhabi",
        "spotify",
        "carrington_malin",
        "egypt",
        "daniel_valle",
        "anghami",
        "dubai_chambers",
        "algorithmic_governance",
        "media_and_journalism",
        "qatar_university",
        "dubai_university",
        "food_safety",
        "casablanca",
        "artificial_intelligence_and_machine_learning",
        "financial_services",
        "generative_ai_and_foundation_models",
        "japan",
        "deezer",
        "morocco",
        "technology",
        "muhammad_khalid",
        "saudi_arabia"
      ]
    }
  ],
  "pagination": {
    "limit": 1,
    "num_results": 1,
    "next_cursor": "eyJ2IjoxLCJpZCI6IjcyZjE2NTc4LWY5YjMtNTkyMS1iNTk1LTkwOTc3ZDAwNDkzZCIsImMiOiIyMDI2LTA4LTIzVDIyOjAwOjQzLTA0OjAwIn0"
  },
  "meta": {
    "as_of": "2026-08-24T20:36:18.229694905Z"
  }
}

json

Inspect one Signal

GET

https://api.cafecito.tech

/espresso/signals/{signal_id}

Use after selecting a Signal from a collection. Returns its complete public fields, optional Source provenance, and a link/count for Events that support the conclusion. Carry the Signal ID to /signals/{signal_id}/events when an answer needs concrete supporting developments. created_at is record creation time.

Inspect one Signal › path Parameters

signal_id

string · uuid · required

Signal UUID (RFC 4122).

Inspect one Signal › query Parameters

response_type

string · enum

Response serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients. JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.

Enum values:

json

yaml

toon

Default: json

Inspect one Signal › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Inspect one Signal › Responses

Signal detail envelope

SignalDetailResponse

SignalDetail · required

Signal detail record. Collection Signal fields plus conditional links and counts.

GET/espresso/signals/{signal_id}

curl https://api.cafecito.tech/espresso/signals/:signal_id \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": {
    "base_url": null,
    "categories": [
      "media_and_journalism",
      "artificial_intelligence_and_machine_learning",
      "generative_ai_and_foundation_models"
    ],
    "companies": [
      "dubai_university",
      "spotify",
      "qatar_university"
    ],
    "confidence": "high",
    "counts": {
      "events": 24
    },
    "created_at": "2026-08-23T22:00:43-04:00",
    "drivers": [
      "Governing bodies implement structured AI policies",
      "Private firms leverage AI for competitive advantage"
    ],
    "future_outlook": "Continued acceleration of AI-integrated economic activity across North Africa and Southern Europe",
    "id": "72f16578-f9b3-5921-b595-90977d00493d",
    "impact_level": "high",
    "impacted_domains": [
      "technology",
      "food_safety",
      "financial_services",
      "algorithmic_governance"
    ],
    "impacts": [
      "Trade increases via efficient logistics",
      "Environment protects from algal blooms",
      "Capital inflow fuels AI ventures",
      "Data quality rises with fraud prevention"
    ],
    "key_points": [
      "2026-07-25 UAE launches AI policy training program",
      "2026-07-25 Morocco deploys AI drones to control toxic algae",
      "2026-07-25 Saudi AI startups achieve 5x revenue over traditional rivals",
      "2026-07-25 SDAIA publishes AI bias mapping guide for 100+ types"
    ],
    "kind": "signal",
    "links": {
      "events": "/signals/72f16578-f9b3-5921-b595-90977d00493d/events"
    },
    "people": [
      "anghami",
      "carrington_malin",
      "muhammad_khalid",
      "deezer",
      "daniel_valle",
      "dubai_chambers"
    ],
    "regions": [
      "oman",
      "casablanca",
      "egypt",
      "saudi_arabia",
      "morocco",
      "japan",
      "riyadh",
      "abu_dhabi"
    ],
    "source_id": null,
    "summary": "Multiple high‑impact AI initiatives unfolded concurrently in late July 2026, including UAE policy formation, Moroccan agricultural monitoring, Saudi startup success stories, and Saudi agency standardisation. Drivers included proactive regulatory action and entrepreneurial responsiveness driving tangible returns, safety improvements and confidence building.",
    "tags": [
      "oman",
      "riyadh",
      "abu_dhabi",
      "spotify",
      "carrington_malin",
      "egypt",
      "daniel_valle",
      "anghami",
      "dubai_chambers",
      "algorithmic_governance",
      "media_and_journalism",
      "qatar_university",
      "dubai_university",
      "food_safety",
      "casablanca",
      "artificial_intelligence_and_machine_learning",
      "financial_services",
      "generative_ai_and_foundation_models",
      "japan",
      "deezer",
      "morocco",
      "technology",
      "muhammad_khalid",
      "saudi_arabia"
    ],
    "url": null
  }
}

json

Inspect Events supporting a Signal

GET

https://api.cafecito.tech

/espresso/signals/{signal_id}/events

Use after selecting a Signal when an agent must explain, verify, or cite the concrete developments behind its conclusion. Returns Events that support the Signal. Apply Event filters only to narrow this existing support set. This route does not perform a new semantic search and does not return unrelated Events. An empty collection means no supporting Events match the supplied filters.

Inspect Events supporting a Signal › path Parameters

signal_id

string · uuid · required

Signal UUID (RFC 4122).

Inspect Events supporting a Signal › query Parameters

ids

string[] · style: form

Restrict returned Events to Event UUIDs (CSV).

event_types

string[] · style: form

Exact Event type names in snake_case (CSV), for example policy_change,market_entry.

categories

string[] · style: form

Exact category names in snake_case (CSV), for example regulation,technology. This is separate from event_types.

entities

string[] · style: form

Exact entity names in snake_case, matched against company or people names (CSV), for example microsoft,nvidia.

impact_levels

string[] · style: form

Exact impact-level names (CSV), for example high,medium.

companies

string[] · style: form

Exact company names in snake_case (CSV), for example microsoft,nvidia.

people

string[] · style: form

Exact person names in snake_case (CSV), for example sam_altman,elon_musk.

products

string[] · style: form

Exact product names in snake_case (CSV), for example windows,geforce.

regions

string[] · style: form

Exact region names in snake_case (CSV), for example north_america,europe.

source_ids

string[] · style: form

Restrict returned Events to Source UUIDs (CSV).

tags

string[] · style: form

Fuzzy text match against persisted Event tag labels (CSV).

from

string · date

Inclusive Event created_at lower bound (YYYY-MM-DD).

to

string · date

Inclusive Event created_at upper bound (YYYY-MM-DD).

response_type

string · enum

Response serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients. JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.

Enum values:

json

yaml

toon

Default: json

limit

integer · min: 1 · max: 100

Maximum records per page. Default 20, max 100.

Default: 20

cursor

string

Opaque continuation token. Send pagination.next_cursor from a previous response unchanged as cursor; never construct or decode it.

Inspect Events supporting a Signal › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Inspect Events supporting a Signal › Responses

Events supporting this Signal

EventCollectionResponse

EventDocument[] · required

ResponseMeta · required

Pagination · required

Collection pagination. Send next_cursor unchanged as the next request cursor. The response does not include a cursor echo field.

GET/espresso/signals/{signal_id}/events

curl https://api.cafecito.tech/espresso/signals/:signal_id/events \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "created_at": "2026-08-23T22:00:43-04:00",
      "drivers": [
        "UAE AI Programme adding Agentic AI focus",
        "Enclave42 launching verifiable AI inference service",
        "Syira AI expanding international presence with Doha office"
      ],
      "event_type": "ai_sector_expansion_in_middle_east",
      "future_outlook": "Continued expansion of AI infrastructure across GCC nations with increased investment in agentic systems",
      "id": "3a479e3c-a87d-591e-bb6c-5c83c03b6a40",
      "impact_level": "high",
      "impacted_domains": [
        "artificial_intelligence",
        "technology",
        "business_development",
        "regional_economic_growth"
      ],
      "impacts": [
        "Increased agentic AI adoption in UAE",
        "New AI inference capabilities deployed in Dubai",
        "International market entry by Syira AI"
      ],
      "key_points": [
        "UAE AI Programme adds Agentic AI focus",
        "Enclave42 launches verifiable AI inference in Dubai",
        "Syira AI opens new Doha Office"
      ],
      "kind": "event",
      "people": [
        "carrington_malin"
      ],
      "summary": "The Middle East AI News Minute highlights three major developments: UAE's AI Programme now emphasizes agentic AI capabilities, Enclave42 has launched verifiable AI inference in Dubai, and Syira AI opened a new office in Doha. These moves indicate accelerating AI adoption across regional markets. The UAE programme represents a strategic shift toward autonomous AI applications, while Enclave42's launch addresses verification needs in enterprise settings. Syira's expansion signals growing foreign direct investment in AI talent and operations within the region.",
      "tags": [
        "artificial_intelligence",
        "regional_economic_growth",
        "business_development",
        "carrington_malin",
        "generative_ai_and_foundation_models",
        "artificial_intelligence_and_machine_learning",
        "ai_sector_expansion_in_middle_east",
        "technology"
      ]
    }
  ],
  "pagination": {
    "limit": 1,
    "num_results": 1,
    "next_cursor": "eyJ2IjoxLCJpZCI6IjNhNDc5ZTNjLWE4N2QtNTkxZS1iYjZjLTVjODNjMDNiNmE0MCIsImMiOiIyMDI2LTA4LTIzVDIyOjAwOjQzLTA0OjAwIn0"
  },
  "meta": {
    "as_of": "2026-08-24T20:38:44.545869075Z"
  }
}

json

Events Sources

Find synthesized Signals

GET

https://api.cafecito.tech

/espresso/signals

Find synthesized Signals › query Parameters

q

string · maxLength: 1024

Optional natural-language semantic query. Max 1024 characters.

score_threshold

number · min: 0 · max: 1

Minimum semantic similarity threshold for q. 0.0 is broad and 1.0 is strict. Default 0.5.

Default: 0.5

from

string · date

Inclusive Signal created_at lower bound (YYYY-MM-DD).

to

string · date

Inclusive Signal created_at upper bound (YYYY-MM-DD).

ids

string[] · style: form

Restrict to Signal UUIDs (CSV).

impact_levels

string[] · style: form

Exact impact-level names (CSV), for example high,medium.

impacted_domains

string[] · style: form

Exact impacted-domain names in snake_case (CSV), for example public_health,climate.

tags

string[] · style: form

Fuzzy text match against persisted Signal tag labels (CSV).

response_type

string · enum

Response serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients. JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.

Enum values:

json

yaml

toon

Default: json

limit

integer · min: 1 · max: 100

Maximum records per page. Default 20, max 100.

Default: 20

cursor

string

Opaque continuation token. Send pagination.next_cursor from a previous response unchanged as cursor; never construct or decode it.

Find synthesized Signals › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Find synthesized Signals › Responses

Signal collection envelope

SignalCollectionResponse

SignalDocument[] · required

ResponseMeta · required

Pagination · required

Collection pagination. Send next_cursor unchanged as the next request cursor. The response does not include a cursor echo field.

Inspect one Signal

GET

https://api.cafecito.tech

/espresso/signals/{signal_id}

Inspect one Signal › path Parameters

signal_id

string · uuid · required

Signal UUID (RFC 4122).

Inspect one Signal › query Parameters

response_type

string · enum

Response serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients. JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.

Enum values:

json

yaml

toon

Default: json

Inspect one Signal › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Inspect one Signal › Responses

Signal detail envelope

SignalDetailResponse

SignalDetail · required

Signal detail record. Collection Signal fields plus conditional links and counts.

Inspect Events supporting a Signal

GET

https://api.cafecito.tech

/espresso/signals/{signal_id}/events

Inspect Events supporting a Signal › path Parameters

signal_id

string · uuid · required

Signal UUID (RFC 4122).

Inspect Events supporting a Signal › query Parameters

ids

string[] · style: form

Restrict returned Events to Event UUIDs (CSV).

event_types

string[] · style: form

Exact Event type names in snake_case (CSV), for example policy_change,market_entry.

categories

string[] · style: form

Exact category names in snake_case (CSV), for example regulation,technology. This is separate from event_types.

entities

string[] · style: form

Exact entity names in snake_case, matched against company or people names (CSV), for example microsoft,nvidia.

impact_levels

string[] · style: form

Exact impact-level names (CSV), for example high,medium.

companies

string[] · style: form

Exact company names in snake_case (CSV), for example microsoft,nvidia.

people

string[] · style: form

Exact person names in snake_case (CSV), for example sam_altman,elon_musk.

products

string[] · style: form

Exact product names in snake_case (CSV), for example windows,geforce.

regions

string[] · style: form

Exact region names in snake_case (CSV), for example north_america,europe.

source_ids

string[] · style: form

Restrict returned Events to Source UUIDs (CSV).

tags

string[] · style: form

Fuzzy text match against persisted Event tag labels (CSV).

from

string · date

Inclusive Event created_at lower bound (YYYY-MM-DD).

to

string · date

Inclusive Event created_at upper bound (YYYY-MM-DD).

response_type

string · enum

Response serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients. JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.

Enum values:

json

yaml

toon

Default: json

limit

integer · min: 1 · max: 100

Maximum records per page. Default 20, max 100.

Default: 20

cursor

string

Opaque continuation token. Send pagination.next_cursor from a previous response unchanged as cursor; never construct or decode it.

Inspect Events supporting a Signal › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Inspect Events supporting a Signal › Responses

Events supporting this Signal

EventCollectionResponse

EventDocument[] · required

ResponseMeta · required

Pagination · required

Collection pagination. Send next_cursor unchanged as the next request cursor. The response does not include a cursor echo field.