Global News Analyzer · Acciones GPT

{
  "openapi": "3.1.0",
  "info": {
    "title": "GDELT DOC 2.0 API",
    "description": "This API allows users to search GDELT's massive database of news documents.",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.gdeltproject.org/api/v2"
    }
  ],
  "paths": {
    "/doc/doc": {
      "get": {
        "summary": "Search news documents",
        "description": "Allows users to search for news documents based on various criteria.",
        "operationId": "searchNewsDocuments",
        "parameters": [
          {
            "name": "query",
            "in": "query",
            "description": "Supports complex queries. Use \"donald trump\" for exact phrases. Combine terms with OR in parentheses: \"(clinton or sanders or trump)\". Exclude with a minus, e.g., \"-sourcelang:spanish\". Domain filters: \"domain:cnn.com\", \"domainis:un.org\". Proximity search: \"near20:\"trump putin\"\". Word repetition: \"repeat3:\"trump\"\". Filter by publication country: \"sourcecountry:france\", and language: \"sourcelang:spanish\". Search GKG themes with \"theme:TERROR\". For article tone, use \"tone<-5\" for negative, and \"toneabs>10\" for high emotion.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "mode",
            "in": "query",
            "description": "'ArtList' offers a basic news article list with social images and details. 'ArtGallery' adds a visual layout for displays. 'ImageCollage' shows processed images linked to articles. 'ImageCollageInfo' includes web occurrence and metadata. 'ImageGallery' has a visual layout, and 'ImageCollageShare' lists social images. 'TimelineVol' displays news volume over time, 'TimelineVolRaw' and 'Info' add raw counts and top articles. 'TimelineTone' shows coverage tone, 'WordCloudImageTags' analyzes images for key topics.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "maxrecords",
            "in": "query",
            "description": "Maximum number of records to return.",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "timespan",
            "in": "query",
            "description": "Specifies the time span for the query, such as '3d' for the past three days.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "startdatetime",
            "in": "query",
            "description": "The start date and time for the query in ISO 8601 format, such as '2023-11-01T00:00:00Z'. Do not use if using timespan",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "enddatetime",
            "in": "query",
            "description": "The end date and time for the query in ISO 8601 format, such as '2023-11-08T00:00:00Z'. Do not use if using timespan",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "The sort order of the results. Valid options: DateDesc, DateAsc, ToneDesc, ToneAsc, HybridRel.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "The format of the response, such as 'json' or 'xml'.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    }
  }
}