> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Scrape the Investing.com economic calendar

> Returns the economic calendar for a date range: each entry in `events` has `name`, `country`, `countryCode`, `currency`, `importance` (high, medium, low), `time` (ISO 8601, UTC), the reference `period`, `actual`, `forecast` and `previous` as numbers with their `unit`, `category`, `source` and a link to the indicator's page. Filter by `countries` and `importance`. Dates default to today (UTC); a range can span up to 31 days. A range with no events returns an empty `events` list. `truncated` is true if the list had to stop early.



## OpenAPI

````yaml /api-reference/openapi.json post /finance/investing-economic-calendar
openapi: 3.1.0
info:
  title: ScrapeUnblocker API
  description: >-
    Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate
    every request with the `x-scrapeunblocker-key` header. Documented here:
    page-source extraction, Google SERP scraping, image fetch, and the dedicated
    plugin endpoints (search engines, marketplaces, reviews, travel, social and
    more). All other paths exist for internal operations and are intentionally
    hidden from this spec.
  version: 3.0.0
servers:
  - url: https://api.scrapeunblocker.com
    description: Production
security: []
paths:
  /finance/investing-economic-calendar:
    post:
      tags:
        - Plugins
      summary: Scrape the Investing.com economic calendar
      description: >-
        Returns the economic calendar for a date range: each entry in `events`
        has `name`, `country`, `countryCode`, `currency`, `importance` (high,
        medium, low), `time` (ISO 8601, UTC), the reference `period`, `actual`,
        `forecast` and `previous` as numbers with their `unit`, `category`,
        `source` and a link to the indicator's page. Filter by `countries` and
        `importance`. Dates default to today (UTC); a range can span up to 31
        days. A range with no events returns an empty `events` list. `truncated`
        is true if the list had to stop early.
      operationId: investing_economic_calendar_finance_investing_economic_calendar_post
      parameters:
        - name: date_from
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: First day, YYYY-MM-DD. Defaults to today (UTC).
            title: Date From
          description: First day, YYYY-MM-DD. Defaults to today (UTC).
        - name: date_to
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Last day, YYYY-MM-DD. Defaults to `date_from`.
            title: Date To
          description: Last day, YYYY-MM-DD. Defaults to `date_from`.
        - name: countries
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Comma-separated ISO-2 codes or names, e.g. 'US,DE,JP' or 'United
              States,Euro Zone'. 'EU' is the Euro Zone. Leave blank for all.
            title: Countries
          description: >-
            Comma-separated ISO-2 codes or names, e.g. 'US,DE,JP' or 'United
            States,Euro Zone'. 'EU' is the Euro Zone. Leave blank for all.
        - name: importance
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: 'Comma-separated: ''high'', ''medium'', ''low''. Leave blank for all.'
            title: Importance
          description: 'Comma-separated: ''high'', ''medium'', ''low''. Leave blank for all.'
        - name: proxy_country
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE').
              Leave blank to let the API pick.
            title: Proxy Country
          description: >-
            Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE').
            Leave blank to let the API pick.
      responses:
        '200':
          description: JSON with an `events` array and `total`.
          content:
            application/json:
              schema: {}
        '400':
          description: >-
            A date, `countries` or `importance` is invalid, or the proxy country
            is.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: Blocked, or the call did not finish in time.
      security:
        - ScrapeUnblockerKey: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ScrapeUnblockerKey:
      type: apiKey
      in: header
      name: x-scrapeunblocker-key
      description: Your ScrapeUnblocker API key. Apply on every request.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.