{
  "openapi": "3.0.1",
  "info": {
    "title": "Amazon Influencer Storefronts Scraper",
    "description": "Extract public Amazon influencer profiles and collections from storefront URLs or handles. Optionally expand collections into visible recommended products or include creator videos, and filter by marketplace or public signals. No Amazon login is needed.",
    "version": "0.0",
    "x-build-id": "YVsgvC64jswuKBQjW"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/maximedupre~amazon-influencer-storefronts/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-maximedupre-amazon-influencer-storefronts",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/maximedupre~amazon-influencer-storefronts/runs": {
      "post": {
        "operationId": "runs-sync-maximedupre-amazon-influencer-storefronts",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/maximedupre~amazon-influencer-storefronts/run-sync": {
      "post": {
        "operationId": "run-sync-maximedupre-amazon-influencer-storefronts",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "target"
        ],
        "properties": {
          "target": {
            "title": "Target type",
            "enum": [
              "storefronts",
              "collection"
            ],
            "type": "string",
            "description": "Choose the public Amazon source to inspect. Choose Influencer storefronts for a list of URLs or handles. Choose Idea List collection for one public collection URL."
          },
          "storefronts": {
            "title": "Storefront URLs or handles",
            "minItems": 1,
            "type": "array",
            "description": "Add one or more public Amazon influencer storefront URLs or handles. The same extraction scope, marketplace, and locale apply to every entry. Use this only when Target is Influencer storefronts.",
            "items": {
              "type": "string",
              "minLength": 1
            }
          },
          "marketplace": {
            "title": "Marketplace for handles",
            "type": "string",
            "description": "Choose the Amazon marketplace for entries that are handles. A full URL keeps its own marketplace. This is used only for Influencer storefronts."
          },
          "locale": {
            "title": "Locale for handles",
            "type": "string",
            "description": "Optionally set a locale such as en-US for storefront handles. The source may ignore it when that storefront does not support locale selection. This is used only for Influencer storefronts."
          },
          "includeVideos": {
            "title": "Include creator videos",
            "type": "boolean",
            "description": "Turn this on to return public creator-video records from storefronts. Creator videos have a separate event charge. This is used only for Influencer storefronts.",
            "default": false
          },
          "filterMarketplace": {
            "title": "Filter by marketplace",
            "type": "string",
            "description": "Keep only storefronts that report the selected public marketplace. Leave it empty to keep all marketplaces. This is used only for Influencer storefronts."
          },
          "topCreatorFilter": {
            "title": "Top-creator filter",
            "enum": [
              "any",
              "top_creator",
              "not_top_creator"
            ],
            "type": "string",
            "description": "Choose whether returned storefronts must show a public top-creator signal. Any keeps both kinds. This is used only for Influencer storefronts."
          },
          "affiliateStatusFilter": {
            "title": "Affiliate status filter",
            "enum": [
              "any",
              "disclosed",
              "no_disclosure"
            ],
            "type": "string",
            "description": "Choose whether returned storefronts must show a public affiliate disclosure. Any keeps both kinds. This is used only for Influencer storefronts."
          },
          "curationFilter": {
            "title": "Curation filter",
            "enum": [
              "any",
              "present",
              "not_present"
            ],
            "type": "string",
            "description": "Choose whether returned storefronts must show a public curation signal. Any keeps both kinds. This is used only for Influencer storefronts."
          },
          "activityFilter": {
            "title": "Activity filter",
            "enum": [
              "any",
              "present",
              "not_present"
            ],
            "type": "string",
            "description": "Choose whether returned storefronts must show public activity signals. Any keeps both kinds. This is used only for Influencer storefronts."
          },
          "collectionUrl": {
            "title": "Collection URL",
            "pattern": "^https?://(?:www\\.)?amazon\\.[A-Za-z0-9.-]+/.+$",
            "type": "string",
            "description": "Enter one public Amazon Idea List or collection URL. Use this only when Target is Idea List collection."
          },
          "expandCollections": {
            "title": "Expand collections into products",
            "type": "boolean",
            "description": "Turn this on to expand visible public collections into recommended product records. Profile and collection context are returned either way. This applies to both targets and has a separate product event charge.",
            "default": false
          },
          "maxItems": {
            "title": "Maximum items to process",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many output records are processed. Leave it empty to return all available results until the public source is exhausted. This limit applies to both targets."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}