{
  "openapi": "3.0.1",
  "info": {
    "title": "Adobe Stock Keyword & Title Generator: Bulk Metadata CSV",
    "description": "Titles, 45 ranked keywords, categories and upload-ready CSV files for Adobe Stock, Shutterstock and Freepik from images. Inputs: image links, a ZIP upload, CSV or Google Sheet, dataset; keywordCount, generativeAi, bannedWords. Charged per image described. Agent-ready: x402, MCP.",
    "version": "0.1",
    "x-build-id": "AdAuG2xUT5K3ORTyd"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/nerolabs~adobe-stock-keyword-generator/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-nerolabs-adobe-stock-keyword-generator",
        "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/nerolabs~adobe-stock-keyword-generator/runs": {
      "post": {
        "operationId": "runs-sync-nerolabs-adobe-stock-keyword-generator",
        "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/nerolabs~adobe-stock-keyword-generator/run-sync": {
      "post": {
        "operationId": "run-sync-nerolabs-adobe-stock-keyword-generator",
        "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",
        "properties": {
          "images": {
            "title": "Image links",
            "type": "array",
            "description": "Links to your images (JPG, PNG, WEBP, TIFF, HEIC), one per line. Each image is charged once, only when its title and keywords come back. Or upload a ZIP below, or give a CSV, Google Sheet or dataset.",
            "items": {
              "type": "string"
            }
          },
          "zipFile": {
            "title": "ZIP file or image",
            "type": "string",
            "description": "Upload a ZIP of your images (or one image), or paste a link to one (Dropbox, a Google Drive file link, your own site). File names inside the ZIP are kept, so the CSVs match your uploads."
          },
          "fileUrl": {
            "title": "File or Google Sheet URL",
            "type": "string",
            "description": "A public CSV, Excel, JSON or Google Sheet with one image link per row. Optional columns: filename (the name you upload under), prompt (the AI prompt, used as a hint and filled into the Freepik CSV) and context (a hint like a place name). Other columns are kept. Used when no images or ZIP are given."
          },
          "datasetId": {
            "title": "Dataset",
            "type": "string",
            "description": "An Apify dataset with image links, for example the output of an AI image generator Actor. Used when no images, ZIP or file are given."
          },
          "imageField": {
            "title": "Image link column",
            "type": "string",
            "description": "For a file or dataset: the column with the image link. Leave empty to detect it (image_url, image, url, images)."
          },
          "platforms": {
            "title": "CSV files to make",
            "type": "array",
            "description": "Which upload CSV files to write. Each is saved in the run's key-value store and linked in the Summary.",
            "items": {
              "type": "string",
              "enum": [
                "adobe",
                "shutterstock",
                "freepik",
                "generic"
              ],
              "enumTitles": [
                "Adobe Stock",
                "Shutterstock",
                "Freepik (Magnific)",
                "All fields (any site)"
              ]
            },
            "default": [
              "adobe",
              "shutterstock",
              "freepik",
              "generic"
            ]
          },
          "generativeAi": {
            "title": "These are AI-generated images",
            "type": "boolean",
            "description": "Turn on for images made with Midjourney, Firefly, Flux and similar tools. The title and keywords then describe what is shown without mentioning AI (Adobe and Shutterstock label AI content themselves), and people are treated as fictional, so no model release warning.",
            "default": false
          },
          "keywordCount": {
            "title": "Keywords per image",
            "minimum": 5,
            "maximum": 49,
            "type": "integer",
            "description": "How many keywords to keep, most important first. Adobe Stock allows 49 and weights the first 10 most; Shutterstock allows 50.",
            "default": 45
          },
          "titleMaxLength": {
            "title": "Title max length",
            "minimum": 30,
            "maximum": 200,
            "type": "integer",
            "description": "Adobe Stock recommends titles under 70 characters (200 is the hard limit).",
            "default": 70
          },
          "context": {
            "title": "Hint for every image",
            "type": "string",
            "description": "Optional. Something the image cannot show, used for every image, for example 'Lisbon, Portugal' or 'Christmas collection'. Ignored when it does not match what is seen."
          },
          "mustIncludeKeywords": {
            "title": "Always include keywords",
            "type": "array",
            "description": "Optional. Keywords put first on every image, for example a series or location name.",
            "items": {
              "type": "string"
            }
          },
          "bannedWords": {
            "title": "Never use these words",
            "type": "array",
            "description": "Optional. Extra words to strip from titles and keywords. Famous brands, trademarks, artist names and AI tool names are already removed.",
            "items": {
              "type": "string"
            }
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "Language for titles and keywords. Adobe Stock and Shutterstock want English.",
            "default": "English"
          },
          "model": {
            "title": "Model",
            "enum": [
              "fast",
              "best"
            ],
            "type": "string",
            "description": "Fast (Gemini Flash Lite) costs about $0.0003 per image of model fee, billed to your Apify account by Apify's OpenRouter proxy. Best (Gemini Flash) notices more detail, about $0.002 per image. Same Actor price.",
            "default": "fast"
          },
          "fileFormat": {
            "title": "File format",
            "enum": [
              "auto",
              "csv",
              "tsv",
              "json",
              "jsonl",
              "xlsx"
            ],
            "type": "string",
            "description": "Leave on auto unless the file is detected wrongly.",
            "default": "auto"
          },
          "sheetName": {
            "title": "Excel sheet name",
            "type": "string",
            "description": "For an Excel file: which sheet to read."
          },
          "keepOriginalFields": {
            "title": "Keep original columns",
            "type": "boolean",
            "description": "Copy the other columns of a file or dataset row onto the output row.",
            "default": true
          },
          "concurrency": {
            "title": "Images at once",
            "minimum": 1,
            "maximum": 16,
            "type": "integer",
            "description": "How many images are described at the same time.",
            "default": 8
          },
          "maxItems": {
            "title": "Max images",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Stop after this many images."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}