Raw Webhooks

Raw Webhooks are a lightweight, fast-delivery alternative to standard (enriched) webhooks. They deliver core article data the moment it is published, skipping the AI enrichment pipeline entirely.

Key differences from Enriched Webhooks:

  • Faster delivery — articles are pushed as soon as they are ingested, without waiting for sentiment analysis, entity resolution, or company matching.
  • Simplified filters — only query, sources, excludeSources, and language are supported. tickers, countries, categories, includeContent, includeEntities, and excludeEmptyContent are not available.
  • No AI enrichment — payloads contain no sentiment, confidence, or companies data.
  • Query field-level filtering — the query parameter supports field-level syntax for source, title, and summary only.
  • Immutable type — the delivery type (raw or enriched) is set at creation and cannot be changed afterwards.

Article model

Raw Webhooks deliver a simplified article payload. No company entities, sentiment scores, or AI-generated enrichments are included.

  • Name
    link
    Type
    string
    Description

    URL to the full article.

  • Name
    source
    Type
    string
    Description

    Source website. E.g. www.reuters.com

  • Name
    title
    Type
    string
    Description

    Title of the article.

  • Name
    summary
    Type
    string
    Description

    Summary of the article if available. Can be nullable.

  • Name
    publishDate
    Type
    Date
    Description

    Publication date as ISO 8601 date string.

  • Name
    createdAt
    Type
    Date
    Description

    Internal creation date of the article in the finlight system as ISO 8601 date string.

  • Name
    language
    Type
    string
    Description

    Language code in ISO 639-1. E.g. en | de | fr

  • Name
    images
    Type
    string[]
    Description

    Array of image URLs from the article.

  • Name
    countries
    Type
    string[]
    Description

    Array of country codes in ISO 3166-1 alpha-2 format. E.g. ["US", "GB"]. Can be empty.

  • Name
    categories
    Type
    string[]
    Description

    Array of article categories. Possible values: markets | economy | business | politics | geopolitics | regulation | technology | energy | commodities | crypto | health | climate | security. Can be empty.

WEBHOOKDelivery Type

Create a Raw Webhook

When creating a webhook in the finlight dashboard, select Raw as the delivery type in the first step of the setup wizard. The criteria step will then show only the four supported filter parameters.

Raw Webhooks deliver only newly published articles that match your criteria. Each delivery is a single article payload sent as an HTTP POST request to your endpoint.

  • Name
    query
    Type
    string
    Description

    Search query to find relevant articles. Supports field-level filtering for source, title, and summary fields. See query field-level filtering below.

  • Name
    sources
    Type
    string[]
    Description

    Limit delivery to articles from specific sources. E.g. ["www.reuters.com", "www.cnbc.com"]. See the sources endpoint for valid values.

  • Name
    excludeSources
    Type
    string[]
    Description

    Exclude articles from specific sources. E.g. ["www.example.com"].

  • Name
    language
    Type
    string
    Description

    Filter by article language. Language code in ISO 639-1. Defaults to en when not set.

Response

{
  "link": "https://www.example.com/article1",
  "source": "www.example.com",
  "title": "Stock Market Hits New Highs",
  "summary": "A brief summary of the article...",
  "publishDate": "2023-10-01T12:34:56Z",
  "createdAt": "2023-10-01T12:35:10Z",
  "language": "en",
  "images": [
    "https://www.example.com/image1.jpg",
    "https://www.example.com/image2.jpg"
  ],
  "countries": ["US"],
  "categories": ["markets"]
}

Query Field-Level Filtering

The query parameter for Raw Webhooks supports field-level filtering scoped to these fields only:

  • source — filter by article source domain
  • title — filter by content in the article title
  • summary — filter by content in the article summary

Examples:

query=title:Nvidia

Delivers articles where the title contains "Nvidia".

query=summary:earnings +title:Tesla

Delivers articles where the summary mentions "earnings" and the title contains "Tesla".

query=source:www.reuters.com -crypto

Delivers articles from Reuters, excluding those mentioning "crypto".

See the Advanced Query Building guide for the full query syntax reference.

GUIDEDecision Help

When to Use Raw Webhooks

Choose Raw when you:

  • Need the lowest possible delivery latency
  • Are building a high-throughput pipeline where enrichment data is not required
  • Only need to filter by keywords, sources, or language
  • Want a leaner payload to reduce processing overhead on your end

Choose Enriched when you:

  • Need company/ticker-level filtering (tickers, countries, categories)
  • Want sentiment scores, confidence values, or entity resolution in the payload
  • Need to include full article content or extracted entities via includeContent / includeEntities
  • Are building equity monitoring, earnings tracking, or sector-specific news feeds

For full details on enriched webhook filtering options, see the Filtering Criteria guide.