SEO Focus · GPT 작업

{
  "openapi": "3.0.0",
  "info": {
    "title": "Google Trends API",
    "description": "API for scraping Google Trends results including interest over time, interest by region, related topics, and related queries.",
    "version": "1.0.0",
    "contact": {
      "name": "SerpApi Support",
      "url": "https://serpapi.com/contact",
      "email": "support@serpapi.com"
    }
  },
  "servers": [
    {
      "url": "https://serpapi.com"
    }
  ],
  "paths": {
    "/search": {
      "get": {
        "operationId": "GoogleTrendsSearch",
        "summary": "Retrieve Google Trends Data",
        "description": "Access various types of Google Trends data including interest over time, interest by region, related topics, and related queries.",
        "parameters": [
          {
            "name": "engine",
            "in": "query",
            "required": true,
            "description": "Set to 'google_trends' to use the Google Trends API engine.",
            "schema": {
              "type": "string",
              "default": "google_trends"
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Query or queries to search, separated by commas for multiple queries.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "geo",
            "in": "query",
            "description": "Geographic location from where the search originates, defaults to Worldwide.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "region",
            "in": "query",
            "description": "More specific regional results, options include COUNTRY, REGION, DMA, CITY.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "data_type",
            "in": "query",
            "description": "Type of search, options include TIMESERIES, GEO_MAP, GEO_MAP_0, RELATED_TOPICS, RELATED_QUERIES.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "description": "Time zone, default is 420 (PDT).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "cat",
            "in": "query",
            "description": "Search category, default is 0 (All categories).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "gprop",
            "in": "query",
            "description": "Sorting results by property, options include images, news, froogle, youtube.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "date",
            "in": "query",
            "description": "Date range for the search.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "csv",
            "in": "query",
            "description": "Set to true to retrieve CSV results.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "no_cache",
            "in": "query",
            "description": "Set to true to force fetching new results, ignoring cache.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "async",
            "in": "query",
            "description": "Set to true to submit search asynchronously.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "api_key",
            "in": "query",
            "required": true,
            "description": "SerpApi api key.",
            "schema": {
              "type": "string"
            },
            "default": "0073ed1fbf946573d4834631c7fdbb610413f12c2e0d39ac3d879de94f6e5aa6"
          },
          {
            "name": "output",
            "in": "query",
            "description": "Output format, options include json and html.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response with Google Trends data.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "search_metadata": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "status": {
                          "type": "string"
                        }
                      }
                    },
                    "search_parameters": {
                      "type": "object"
                    },
                    "interest_over_time": {
                      "type": "array"
                    },
                    "compared_breakdown_by_region": {
                      "type": "array"
                    },
                    "interest_by_region": {
                      "type": "array"
                    },
                    "related_topics": {
                      "type": "array"
                    },
                    "related_queries": {
                      "type": "array"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request, possibly due to missing parameters."
          },
          "401": {
            "description": "Unauthorized, API key is missing or invalid."
          },
          "500": {
            "description": "Internal server error."
          }
        }
      }
    }
  }
}