Cart Buddy GPT · Acciones GPT

{
  "openapi": "3.0.0",
  "info": {
    "version": "1.1.0",
    "title": "Cart Buddy GPT API",
    "description": "API endpoint for searching items in the Cart Buddy GPT application."
  },
  "servers": [
    {
      "url": "https://cartbuddygpt.com/api"
    }
  ],
  "paths": {
    "/searchItemsV2": {
      "post": {
        "summary": "Search for items",
        "description": "API endpoint for searching items in Amazon through the Cart Buddy GPT.",
        "operationId": "searchItemsGet",
        "tags": [
          "items"
        ],
        "parameters": [
          {
            "name": "keywords",
            "in": "query",
            "required": true,
            "description": "Search terms used for finding items.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "brand",
            "in": "query",
            "description": "Specific brand name for the item.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sortBy",
            "in": "query",
            "description": "Criteria for sorting the search results.",
            "schema": {
              "type": "string",
              "enum": [
                "RELEVANCE",
                "LOWEST_PRICE",
                "HIGHEST_PRICE",
                "REVIEWS",
                "NEWEST",
                "BEST_SELLERS"
              ]
            }
          },
          {
            "name": "maxPrice",
            "in": "query",
            "description": "Maximum price filter for the search results, in the lowest currency denomination.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "minPrice",
            "in": "query",
            "description": "Minimum price filter for the search results, in the lowest currency denomination.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "Country code for the search results. Default to US.",
            "schema": {
              "type": "string",
              "enum": [
                "US",
                "AU",
                "BR",
                "CA",
                "CN",
                "FR",
                "DE",
                "IN",
                "IT",
                "MX",
                "NL",
                "SG",
                "ES",
                "TR",
                "AE",
                "GB",
                "JP",
                "SA",
                "PL",
                "SE",
                "BE",
                "EG"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "products": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ItemInfo"
                      }
                    },
                    "country": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "unexpected error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ItemInfo": {
        "type": "object",
        "required": [
          "product_url",
          "title",
          "price",
          "unit_price",
          "unit_count",
          "product_photo",
          "rating",
          "number_ratings",
          "is_amazon_choice",
          "is_prime",
          "climate_pledge_friendly",
          "sales_volume",
          "description",
          "product_information",
          "product_details"
        ],
        "properties": {
          "product_url": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "price": {
            "type": "integer",
            "format": "int32"
          },
          "unit_price": {
            "type": "integer",
            "format": "int32"
          },
          "unit_count": {
            "type": "integer",
            "format": "int32"
          },
          "product_photo": {
            "type": "string"
          },
          "rating": {
            "type": "number",
            "format": "float"
          },
          "number_ratings": {
            "type": "integer",
            "format": "int32"
          },
          "is_amazon_choice": {
            "type": "boolean"
          },
          "is_prime": {
            "type": "boolean"
          },
          "climate_pledge_friendly": {
            "type": "boolean"
          },
          "sales_volume": {
            "type": "integer",
            "format": "int32"
          },
          "description": {
            "type": "string"
          },
          "product_information": {
            "type": "object"
          },
          "product_details": {
            "type": "object"
          }
        }
      },
      "Error": {
        "type": "object",
        "required": [
          "code",
          "message"
        ],
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}