{
  "openapi": "3.0.1",
  "info": {
    "title": "Amazon Influencer Storefront Scraper",
    "description": "Extract public Amazon influencer profiles, curations, Idea Lists, and photo posts from storefront URLs or handles, or read a list of Idea List URLs. Set limits for list products, creator videos, and photo posts. No Amazon login is needed.",
    "version": "6.0",
    "x-build-id": "di4MGCelaxecRu5Sn"
  },
  "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": {
          "maxItems": {
            "title": "Maximum results",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many results are saved. Leave it empty or set 0 to get all available results until the public source runs out. This applies to both result types."
          },
          "target": {
            "title": "Result 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 a list of public Idea List URLs."
          },
          "storefronts": {
            "title": "Storefront URLs or handles",
            "minItems": 1,
            "type": "array",
            "description": "Add one or more public Amazon influencer storefront URLs or handles. Use this only when Result type is Influencer storefronts.",
            "items": {
              "type": "string",
              "minLength": 1
            }
          },
          "marketplace": {
            "title": "Marketplace for handles",
            "type": "string",
            "description": "Choose a supported Amazon marketplace for handles. A full URL keeps its own marketplace. 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
          },
          "maxVideosPerStorefront": {
            "title": "Maximum videos per storefront",
            "minimum": 0,
            "type": "integer",
            "description": "Return up to this many creator videos for each storefront, where available. Set 0 to get all videos. This is used only when Include creator videos is on.",
            "default": 10
          },
          "includePhotos": {
            "title": "Include creator photos",
            "type": "boolean",
            "description": "Turn this on to return public creator photo posts from each storefront. Each photo post is saved as its own row. Creator photos have a separate charge. This is used only for Influencer storefronts.",
            "default": false
          },
          "maxPhotosPerStorefront": {
            "title": "Maximum photos per storefront",
            "minimum": 0,
            "type": "integer",
            "description": "Return up to this many creator photo posts for each storefront, where available. Set 0 to get all photos. An omitted value uses 10. This is used only when Include creator photos is on.",
            "default": 10
          },
          "includeIdeaLists": {
            "title": "Include Idea Lists",
            "type": "boolean",
            "description": "Turn this on to return the creator's public Idea Lists with each storefront. Idea Lists have a separate event charge. This is used only for Influencer storefronts.",
            "default": false
          },
          "maxIdeaListsPerStorefront": {
            "title": "Maximum Idea Lists per storefront",
            "minimum": 0,
            "type": "integer",
            "description": "Return up to this many Idea Lists for each storefront, where available. Set 0 to get all Idea Lists. This is used only when Include Idea Lists is on.",
            "default": 20
          },
          "includeCurationPosts": {
            "title": "Include curation posts",
            "type": "boolean",
            "description": "Turn this on to return the public posts grouped in each curation, such as Idea Lists, photos, and videos. Curation posts have a separate charge. This is used only for Influencer storefronts.",
            "default": false
          },
          "maxPostsPerCuration": {
            "title": "Maximum posts per curation",
            "minimum": 0,
            "type": "integer",
            "description": "Return up to this many posts for each curation, where available. Set 0 to get all posts. An omitted value uses 20. This is used only when Include curation posts is on.",
            "default": 20
          },
          "includeCurationPostProducts": {
            "title": "Include curation post products",
            "type": "boolean",
            "description": "Turn this on to return the products tagged in each curation post. Include curation posts must also be on. Curation post products have a separate charge. This is used only for Influencer storefronts.",
            "default": false
          },
          "maxProductsPerCurationPost": {
            "title": "Maximum products per curation post",
            "minimum": 0,
            "type": "integer",
            "description": "Return up to this many products for each curation post, where available. Set 0 to get all products. An omitted value uses 10. This is used only when Include curation post products is on.",
            "default": 10
          },
          "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."
          },
          "contentType": {
            "title": "Post type",
            "enum": [
              "all",
              "idea_lists",
              "photos",
              "videos"
            ],
            "type": "string",
            "description": "Choose all public storefront posts, or only Idea Lists, photos, or videos. This applies to Influencer storefronts. The Include switches still control Idea List, photo, and video data."
          },
          "contentKeyword": {
            "title": "Post keyword",
            "type": "string",
            "description": "Search public posts in each submitted storefront with this keyword or phrase. Leave empty to collect posts without a keyword search. This applies to Influencer storefronts."
          },
          "collectionUrls": {
            "title": "Idea List URLs",
            "minItems": 1,
            "type": "array",
            "description": "Add one or more public Amazon Idea List or collection URLs. Put each URL on its own row. Use this only when Result type is Idea List collection.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "expandCollections": {
            "title": "Include Idea List products",
            "type": "boolean",
            "description": "Turn this on to return products in each Idea List, up to Maximum products per Idea List where available. For Influencer storefronts, Include Idea Lists must also be on. Idea List products have a separate charge.",
            "default": false
          },
          "maxProductsPerIdeaList": {
            "title": "Maximum products per Idea List",
            "minimum": 0,
            "type": "integer",
            "description": "Return up to this many products per Idea List, where available. Set 0 for all products. An omitted value uses 20. This applies only when Include Idea List products is on.",
            "default": 20
          },
          "locale": {
            "title": "Language",
            "type": "string",
            "description": "Choose the language for Amazon labels and available content in both result types. Use a locale such as en-US that the selected marketplace supports. You can enter another supported locale."
          },
          "deliveryPostalCode": {
            "title": "Delivery postal code",
            "minLength": 1,
            "type": "string",
            "description": "Enter a delivery postal code in the Amazon marketplace of the submitted URL or handle. This sets the location for available product prices and availability in both result types. It applies when Include Idea List products is on."
          },
          "outputFields": {
            "title": "Output fields",
            "type": "array",
            "description": "Enter the profile and post field paths to return, such as creator.name or collections.title. Leave empty to return all available fields. This applies to both result types and does not turn on paid data.",
            "items": {
              "type": "string",
              "minLength": 1
            }
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}