Fotofit

Fotofit · Acciones GPT

Google Shopping API Wrapper

  • GET /call_google_shopping_apiSearch products on Google Shopping

    This endpoint allows querying Google Shopping for products based on various criteria like price, location, page number, and specific stores.

Esquema original API
{
  "openapi": "3.0.0",
  "info": {
    "title": "Google Shopping API Wrapper",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://backend.distoai.com",
      "description": "Google Shopping API server"
    }
  ],
  "paths": {
    "/call_google_shopping_api": {
      "get": {
        "operationId": "searchGoogleShopping",
        "summary": "Search products on Google Shopping",
        "description": "This endpoint allows querying Google Shopping for products based on various criteria like price, location, page number, and specific stores.\n",
        "parameters": [
          {
            "in": "query",
            "name": "query",
            "schema": {
              "type": "string"
            },
            "required": true,
            "description": "The search query for products."
          },
          {
            "in": "query",
            "name": "price_max",
            "schema": {
              "type": "number",
              "format": "float"
            },
            "required": false,
            "description": "Maximum price for the returned products. Products with a price higher than this value will not be included."
          },
          {
            "in": "query",
            "name": "zip_code",
            "schema": {
              "type": "string"
            },
            "required": false,
            "description": "ZIP code for location-based results. Used when the 'country' is set to either 'United States' or 'United Kingdom'."
          },
          {
            "in": "query",
            "name": "page",
            "schema": {
              "type": "integer",
              "default": 1
            },
            "required": false,
            "description": "The page number of the results to return. Default is 1. Each page typically contains 10 results."
          },
          {
            "in": "query",
            "name": "num",
            "schema": {
              "type": "integer",
              "default": 10
            },
            "required": false,
            "description": "The number of results to return per page. Default is 10."
          },
          {
            "in": "query",
            "name": "country",
            "schema": {
              "type": "string",
              "enum": [
                "United States",
                "United Kingdom"
              ],
              "default": "United States"
            },
            "required": false,
            "description": "The country for which the results are relevant. Can be either \"United States\" or \"United Kingdom\". Default is \"United States\"."
          },
          {
            "in": "query",
            "name": "stores",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "enum": [
                {
                  "United States": [
                    "& Other Stories",
                    "Abercrombie & Fitch",
                    "Adidas",
                    "Aeropostale",
                    "Amazon",
                    "American Eagle Outfitters",
                    "Ann Taylor",
                    "ASOS",
                    "Banana Republic",
                    "Calvin Klein",
                    "Champion",
                    "Forever 21",
                    "Gap",
                    "H&M",
                    "Hollister",
                    "Hot Topic",
                    "J. Crew",
                    "Levi's",
                    "Lululemon",
                    "Macy's",
                    "Madewell",
                    "Michael Kors",
                    "Nautica",
                    "NET-A-PORTER",
                    "Nordstrom",
                    "Obey",
                    "Old Navy",
                    "PacSun",
                    "Patagonia",
                    "Ralph Lauren",
                    "Saks Fifth Avenue",
                    "SHEIN",
                    "The North Face",
                    "Target",
                    "Tilly's",
                    "Tommy Hilfiger",
                    "Under Armour",
                    "Urban Outfitters",
                    "Volcom",
                    "Zara"
                  ]
                },
                {
                  "United Kingdom": [
                    "& Other Stories",
                    "Abercrombie & Fitch",
                    "Anthropologie",
                    "Arket",
                    "ASOS",
                    "Etsy",
                    "Free People",
                    "H&M",
                    "Mango",
                    "Monica Vinader",
                    "Monki",
                    "Sam Edelman",
                    "Stradivarius",
                    "UNIQLO",
                    "Zalando",
                    "Zara"
                  ]
                }
              ]
            },
            "required": false,
            "description": "A list of specific stores to filter the results. Options vary based on the selected country."
          }
        ],
        "responses": {
          "200": {
            "description": "A list of shopping results.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "shopping_results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "title": {
                            "type": "string"
                          },
                          "link": {
                            "type": "string"
                          },
                          "seller": {
                            "type": "string"
                          },
                          "extracted_price": {
                            "type": "number"
                          },
                          "thumbnail": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request"
          },
          "401": {
            "description": "Unauthorized"
          },
          "500": {
            "description": "Internal Server Error"
          }
        }
      }
    }
  }
}