Update openapi.json

SnowCait · Dec 13, 2023 · 2649de3 · 2649de3
1 parent 33aa76b
commit 2649de3
Showing 1 changed file with 122 additions and 1 deletion.
diff --git a/docs/openapi.v2.json b/docs/openapi.v2.json
@@ -2,7 +2,7 @@
   "openapi" : "3.0.0",
   "info" : {
     "description" : "Twitter API v2 available endpoints",
-    "version" : "2.83",
+    "version" : "2.84",
     "title" : "Twitter API v2",
     "termsOfService" : "https://developer.twitter.com/en/developer-terms/agreement-and-policy.html",
     "contact" : {
@@ -2093,6 +2093,68 @@
         }
       }
     },
+    "/2/trends/by/woeid/{woeid}" : {
+      "get" : {
+        "security" : [
+          {
+            "BearerToken" : [ ]
+          }
+        ],
+        "tags" : [
+          "Trends"
+        ],
+        "summary" : "Trends",
+        "description" : "Returns the Trend associated with the supplied WoeId.",
+        "externalDocs" : {
+          "url" : "https://developer.twitter.com/en/docs/twitter-api/trends/api-reference/get-trends-by-woeid"
+        },
+        "operationId" : "getTrends",
+        "parameters" : [
+          {
+            "name" : "woeid",
+            "in" : "path",
+            "description" : "The WOEID of the place to lookup a trend for.",
+            "required" : true,
+            "example" : "2244994945",
+            "schema" : {
+              "type" : "integer",
+              "format" : "int32"
+            },
+            "style" : "simple"
+          },
+          {
+            "$ref" : "#/components/parameters/TrendFieldsParameter"
+          }
+        ],
+        "responses" : {
+          "200" : {
+            "description" : "The request has succeeded.",
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/Get2TrendsByWoeidWoeidResponse"
+                }
+              }
+            }
+          },
+          "default" : {
+            "description" : "The request has failed.",
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/Error"
+                }
+              },
+              "application/problem+json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/Problem"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/2/tweets" : {
       "get" : {
         "security" : [
@@ -9502,6 +9564,25 @@
           }
         }
       },
+      "Get2TrendsByWoeidWoeidResponse" : {
+        "type" : "object",
+        "properties" : {
+          "data" : {
+            "type" : "array",
+            "minItems" : 1,
+            "items" : {
+              "$ref" : "#/components/schemas/Trend"
+            }
+          },
+          "errors" : {
+            "type" : "array",
+            "minItems" : 1,
+            "items" : {
+              "$ref" : "#/components/schemas/Problem"
+            }
+          }
+        }
+      },
       "Get2TweetsCountsAllResponse" : {
         "type" : "object",
         "properties" : {
@@ -11919,6 +12000,21 @@
         "type" : "string",
         "description" : "Unique identifier of this Topic."
       },
+      "Trend" : {
+        "type" : "object",
+        "description" : "A trend.",
+        "properties" : {
+          "trend_name" : {
+            "type" : "string",
+            "description" : "Name of the trend."
+          },
+          "tweet_count" : {
+            "type" : "integer",
+            "description" : "Number of Tweets in this trend.",
+            "format" : "int32"
+          }
+        }
+      },
       "Tweet" : {
         "type" : "object",
         "required" : [
@@ -14321,6 +14417,31 @@
         "explode" : false,
         "style" : "form"
       },
+      "TrendFieldsParameter" : {
+        "name" : "trend.fields",
+        "in" : "query",
+        "description" : "A comma separated list of Trend fields to display.",
+        "required" : false,
+        "schema" : {
+          "type" : "array",
+          "description" : "The fields available for a Trend object.",
+          "minItems" : 1,
+          "uniqueItems" : true,
+          "items" : {
+            "type" : "string",
+            "enum" : [
+              "trend_name",
+              "tweet_count"
+            ]
+          },
+          "example" : [
+            "trend_name",
+            "tweet_count"
+          ]
+        },
+        "explode" : false,
+        "style" : "form"
+      },
       "TweetExpansionsParameter" : {
         "name" : "expansions",
         "in" : "query",