GET analysis summary

Production

https://api.belga.press/belgapress/api

GET

/analysis

Fetches the aggregated analysis of news objects for a specific time
period.

The analysed objects must be identified either by board UUID or search
query.

The analysis contains:

daily average and total audience reached (number of people)

daily average and total media value (amount of money)

daily average and total number of newly written articles

sentiment score and state

Request

Authorization

OAuth 2.0

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://sso.ssl.belga.be/auth/realms/belga/protocol/openid-connect/auth

Token URL: https://sso.ssl.belga.be/auth/realms/belga/protocol/openid-connect/token

Scopes:

openid

offline_access

profile

email

Query Params

Responses

🟢200OK

application/json

Body

🟠401Unauthorized

🟠403Forbidden

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.belga.press/belgapress/api/analysis?resolution&excludednewsobjectuuids&mustcontain&audiencereachmin&audiencereachmax&authors&board&collapseduplicates&editions&start&end&exactquery&highlight&intro&keyword&languages&mediavaluemax&mediavaluemin&mediumtype&mediumtypegroups&mediumtypegroupids&mediumtypeid&newsuuid&newsuuids&order&pagenr&publisher&searchtext=\"vaccin\" OR \"festival"&sentiment&sourcegroups&sourceid&sourcegroupid&subscription&subsourceid&subsourcegroupid&tagid&title&topicids&wordcountmax&wordcountmin' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "audienceReach": {
        "average": 0,
        "total": 0
    },
    "mediaValue": {
        "average": {
            "amount": "string",
            "currency": "str",
            "includesVat": false
        },
        "total": {
            "amount": "string",
            "currency": "str",
            "includesVat": false
        }
    },
    "sentiment": {
        "score": 0,
        "state": "POSITIVE"
    },
    "writtenArticleCount": {
        "average": 0,
        "total": 0
    }
}

Modified at 2025-11-05 16:04:27

GET auth valid

GET analysis of article count over time