Skip to main content
GET
/
v2
/
events-monitor
/
events
List events
curl --request GET \
  --url https://rest.forestreet.com/v2/events-monitor/events \
  --header 'x-api-key: <api-key>'
{
  "meta": {
    "totalItems": 123,
    "totalPages": 13,
    "currentPage": 1,
    "pageSize": 10,
    "unfilteredTotalItems": 196,
    "unfilteredTotalPages": 20
  },
  "data": [
    {
      "_id": "69e5bfcd21aab5bcbb62eae4",
      "title": "China Sees Greater Integration Between Trade and Investment, Creating New Opportunities",
      "summary": "China’s foreign trade sector is increasingly integrating trade and investment functions, a trend noted by state broadcaster coverage highlighting evolving policy and market structures. This integration can foster deeper value-chain links, encourage inward and outbound investment tied to trade flows, and create procurement opportunities for multinational firms seeking integrated supply-and-investment strategies. For trading companies and investors, integrated approaches can streamline cross-border operations, facilitate production localization and affect supplier selection and partnership models. The narrative indicates potential opportunities for firms to leverage investment to secure market access, though the story does not provide quantitative data or named project examples.",
      "vectorIndex": {
        "anchorText": "a government narrative promoting closer alignment of trade and investment to spur commercial opportunities"
      },
      "lastUpdated": "2026-04-20T05:38:42.448Z",
      "eventSearchKeywords": [
        {
          "keyword": "China foreign trade",
          "propertySource": "inferred"
        },
        {
          "keyword": "investment",
          "propertySource": "inferred"
        },
        {
          "keyword": "trade-investment integration",
          "propertySource": "inferred"
        },
        {
          "keyword": "supply chain",
          "propertySource": "inferred"
        },
        {
          "keyword": "market access",
          "propertySource": "inferred"
        }
      ],
      "relevantEntities": [
        {
          "name": "Trade and Investment Integration",
          "entityType": "category",
          "propertySource": "inferred"
        },
        {
          "name": "Supply Chain Localization",
          "entityType": "category",
          "propertySource": "inferred"
        },
        {
          "name": "China",
          "entityType": "country",
          "propertySource": "inferred"
        }
      ],
      "timestamps": {
        "published": "2026-04-20T05:38:41.505Z",
        "recordedStart": "2026-04-19T14:03:00.073Z"
      },
      "references": [
        {
          "_id": "69e5b8d17a3ce8b7e8505aa5",
          "title": "China’s foreign trade, investment integration generates greater opportunities",
          "url": "https://www.globaltimes.cn/page/202604/1359275.shtml"
        }
      ],
      "taxonomicMatches": {
        "affectedDatapoints": [
          {
            "name": "Net Supply",
            "mappedFrom": "Net Supply",
            "method": "semantic",
            "similarity": 1,
            "rationale": "Found in vector index built from provided texts, using TransformerModel.ALL_MINILM_L6_V2."
          },
          {
            "name": "Unit Price",
            "mappedFrom": "Unit Price",
            "method": "semantic",
            "similarity": 1,
            "rationale": "Found in vector index built from provided texts, using TransformerModel.ALL_MINILM_L6_V2."
          }
        ],
        "alertTypes": [
          {
            "name": "Geopolitical and Trade",
            "mappedFrom": "geopolitical risk",
            "method": "llm",
            "similarity": 1,
            "rationale": "The candidate covers geopolitical risks affecting trade and diplomatic relations."
          },
          {
            "name": "Logistics and Supply Chain",
            "mappedFrom": "supply chain dependency",
            "method": "llm",
            "similarity": 1,
            "rationale": "Directly refers to supply chain logistics and dependencies"
          }
        ],
        "impactedEntities": [
          {
            "name": "Trade Finance Services",
            "entityType": "category",
            "mappedFrom": "trade and investment integration: Strategies that coordinate cross-border trade flows with inward or outward investment decisions.",
            "impact": {
              "likelihood": 2,
              "severity": 1,
              "rationale": "Policy emphasis may encourage firms to pursue combined trade/investment approaches, creating commercial opportunities."
            }
          },
          {
            "name": "Investment Management",
            "entityType": "category",
            "mappedFrom": "trade and investment integration: Strategies that coordinate cross-border trade flows with inward or outward investment decisions.",
            "impact": {
              "likelihood": 2,
              "severity": 1,
              "rationale": "Policy emphasis may encourage firms to pursue combined trade/investment approaches, creating commercial opportunities."
            }
          },
          {
            "name": "Strategy Consulting",
            "entityType": "category",
            "mappedFrom": "trade and investment integration: Strategies that coordinate cross-border trade flows with inward or outward investment decisions.",
            "impact": {
              "likelihood": 2,
              "severity": 1,
              "rationale": "Policy emphasis may encourage firms to pursue combined trade/investment approaches, creating commercial opportunities."
            }
          }
        ]
      }
    }
  ]
}

Authorizations

x-api-key
string
header
required

Pass a static API key for every request, provided by your customer support.

Query Parameters

pageSize
number
default:10

Number of items per page, default is 10, minimum is 1, maximum is 100.

Required range: 1 <= x <= 100
page
number
default:1

Current page number, default is 1.

Required range: x >= 1
from
string
required

Start of lastUpdated date range (ISO 8601). Defaults to 00:00 UTC if no time provided.

to
string
required

End of lastUpdated date range (ISO 8601). Defaults to 23:59 UTC if no time provided.

affectedDatapoint
string

Comma-separated list of affected datapoint names (OR within, AND with other filters).

alertType
string

Comma-separated list of alert type names (OR within, AND with other filters).

impactedEntity
string

Comma-separated list of impacted entity names (OR within, AND with other filters).

Response

The response containing pagination metadata, and an array of zero or more events that satisfy the query parameters.

meta
object
required

Schema for pagination metadata, including total items, total pages, current page, and page size.

Example:
{
  "totalItems": 123,
  "totalPages": 13,
  "currentPage": 1,
  "pageSize": 10,
  "unfilteredTotalItems": 196,
  "unfilteredTotalPages": 20
}
data
object[]
required

A list of events matching the query parameters, within the specified page and page size.