{
  "openapi": "3.0.1",
  "info": {
    "title": "Adobe Stock Scraper & API: Keywords, Downloads, Views",
    "description": "Adobe Stock scraper for assets from keywords, search URLs, asset URLs, contributor portfolios or similar images: keywords, downloads, views, contributor, upload date, AI label, premium, size, previews. Photos, vectors, videos, templates and 3D. Run it on a schedule to follow a niche.",
    "version": "0.1",
    "x-build-id": "VeyF5h91XrBWaE46u"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/quarra~adobe-stock-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-quarra-adobe-stock-scraper",
        "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/quarra~adobe-stock-scraper/runs": {
      "post": {
        "operationId": "runs-sync-quarra-adobe-stock-scraper",
        "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/quarra~adobe-stock-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-quarra-adobe-stock-scraper",
        "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": {
          "searchQueries": {
            "title": "Search keywords or search URLs",
            "type": "array",
            "description": "One per line: keywords (coffee shop), or an Adobe Stock search URL pasted as is (its keywords, language, sort and filters are kept). Each search returns assets in Adobe Stock order, up to 'Max results per search'.",
            "items": {
              "type": "string",
              "maxLength": 2000
            }
          },
          "assetUrls": {
            "title": "Asset URLs or IDs",
            "type": "array",
            "description": "One per line: Adobe Stock asset URLs (photos, vectors, videos, templates, 3D; any language) or asset IDs. Each gets its keywords, downloads, views and details. Assets that no longer exist get a free record.",
            "items": {
              "type": "string",
              "maxLength": 2000
            }
          },
          "contributors": {
            "title": "Contributors",
            "type": "array",
            "description": "One per line: Adobe Stock contributor URLs (stock.adobe.com/contributor/…) or contributor IDs. Returns their portfolio, up to 'Max results per search' each.",
            "items": {
              "type": "string",
              "maxLength": 2000
            }
          },
          "similarTo": {
            "title": "Similar to",
            "type": "array",
            "description": "One per line: an Adobe Stock asset URL or ID, or a direct link to a JPEG or PNG image on the web. Returns visually similar Adobe Stock assets.",
            "items": {
              "type": "string",
              "maxLength": 2000
            }
          },
          "maxItems": {
            "title": "Max assets",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Total number of assets delivered by the run, counted exactly. Free records (errors, assets that no longer exist) are not counted.",
            "default": 100
          },
          "maxResultsPerSearch": {
            "title": "Max results per search",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Assets per search, contributor or similar-to input. Adobe Stock shows at most 10,000 results per search: above 10,000, the Actor splits the search automatically (by content type, orientation, AI-generated, model release, then other sort orders and date ranges) and skips the duplicates, not charged. Each asset beyond the first 10,000 says which part found it (searchPart).",
            "default": 100
          },
          "sort": {
            "title": "Sort",
            "enum": [
              "relevance",
              "downloads",
              "newest",
              "featured",
              "undiscovered"
            ],
            "type": "string",
            "description": "Order of results. A search URL keeps its own sort.",
            "default": "relevance"
          },
          "contentTypes": {
            "title": "Content types",
            "type": "array",
            "description": "Leave empty for all types.",
            "items": {
              "type": "string",
              "enum": [
                "photo",
                "illustration",
                "vector",
                "video",
                "template",
                "3d"
              ],
              "enumTitles": [
                "Photos",
                "Illustrations",
                "Vectors",
                "Videos",
                "Templates",
                "3D"
              ]
            }
          },
          "aiGenerated": {
            "title": "Generative AI",
            "enum": [
              "all",
              "exclude",
              "only"
            ],
            "type": "string",
            "description": "Assets made with generative AI, as labeled by Adobe Stock.",
            "default": "all"
          },
          "premium": {
            "title": "Premium collection",
            "enum": [
              "all",
              "exclude",
              "only"
            ],
            "type": "string",
            "description": "Adobe Stock's premium collection.",
            "default": "all"
          },
          "orientation": {
            "title": "Orientation",
            "enum": [
              "all",
              "horizontal",
              "vertical",
              "square",
              "panoramic"
            ],
            "type": "string",
            "description": "Shape of the asset.",
            "default": "all"
          },
          "addedWithin": {
            "title": "Added within",
            "enum": [
              "any",
              "1w",
              "1m",
              "6m",
              "1y",
              "2y"
            ],
            "type": "string",
            "description": "When the asset was added to Adobe Stock.",
            "default": "any"
          },
          "withModelRelease": {
            "title": "Only with model release",
            "type": "boolean",
            "description": "Only assets with a signed model or property release.",
            "default": false
          },
          "transparentBackground": {
            "title": "Only with transparent background",
            "type": "boolean",
            "description": "Only assets on a transparent background.",
            "default": false
          },
          "copySpace": {
            "title": "Only with copy space",
            "type": "boolean",
            "description": "Only assets with empty space for text.",
            "default": false
          },
          "color": {
            "title": "Color",
            "maxLength": 7,
            "type": "string",
            "description": "A hex color such as FF0000: assets where this color stands out."
          },
          "videoDuration": {
            "title": "Video duration",
            "enum": [
              "any",
              "10",
              "20",
              "30",
              "30-"
            ],
            "type": "string",
            "description": "For videos.",
            "default": "any"
          },
          "language": {
            "title": "Language",
            "enum": [
              "en",
              "en-GB",
              "fr",
              "de",
              "es",
              "it",
              "pt",
              "pt-PT",
              "nl",
              "ja",
              "ko",
              "pl",
              "ru",
              "sv",
              "da",
              "fi",
              "nb",
              "cs",
              "hu",
              "tr"
            ],
            "type": "string",
            "description": "Language of keywords and of how search keywords are read. Titles stay as written by the contributor.",
            "default": "en"
          },
          "onlyNew": {
            "title": "Only new since the last run (monitoring)",
            "type": "boolean",
            "description": "Remember the assets that earlier runs of the same watch delivered, and deliver (and charge) only the assets not delivered before. The first run delivers everything, like a normal run. Assets already delivered are skipped for free and still take their place in 'Max results per search', so each run looks at the same window (for example the 100 newest). Nothing already delivered is charged again, even after a run that timed out, was aborted or was restarted. One run per watch at a time: a second one stops at once. Memory: key-value store quarra-adobe-stock-watch-<this Actor's ID, lowercase> of your account. Set a watch name, then schedule the Actor.",
            "default": false
          },
          "watchName": {
            "title": "Watch name",
            "maxLength": 200,
            "type": "string",
            "description": "Name of the watch that remembers the assets already delivered (used with 'Only new since the last run'). Recommended: runs with the same name share the memory even when you add or remove searches. Empty: the memory belongs to this exact list of inputs and filters, so adding a search starts a new watch that delivers everything again (limits, 'Track downloads' and the connection don't count). Names are case-sensitive; extra spaces are ignored."
          },
          "trackDownloads": {
            "title": "Track downloads of assets already delivered",
            "type": "boolean",
            "description": "With 'Only new since the last run': also deliver the assets already delivered whose downloads changed since their last delivery, with downloadsChange (for example 12) and previousDownloads. Each of these records is charged like any asset. Off: an asset already delivered is never delivered again.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Connection",
            "type": "object",
            "description": "Connection. Keep the default (automatic). Costs are included in the price.",
            "default": {
              "useApifyProxy": true
            }
          },
          "deliveryConnector": {
            "title": "Send results to your app (MCP connector: Notion, Slack…)",
            "type": "string",
            "description": "Pick one of your Apify MCP connectors: at the end of each run, a summary of the results (count, the first 25 with their links, a link to the full dataset) is posted there. With a schedule and 'Only new', you get each day's new results where your team works. Nothing is sent when a run finds nothing. Notion connects in one click; Slack and Google need your own OAuth app in Apify, or use the webhook field below."
          },
          "deliveryTarget": {
            "title": "Where in the app (channel, page or sheet ID)",
            "type": "string",
            "description": "Slack channel ID (C0123…), Notion page ID, Google Sheet ID… Leave empty if the app needs no target (a new Notion page is then created at the top of your workspace)."
          },
          "deliveryWebhookUrl": {
            "title": "Or a webhook URL (Slack, Discord, Make, Zapier, n8n)",
            "type": "string",
            "description": "No connector needed. A Slack Incoming Webhook (hooks.slack.com/…) gets a message, a Discord channel webhook gets a message, any other URL receives the summary as JSON (title, text, count, datasetUrl, items)."
          },
          "deliveryTool": {
            "title": "Connector tool (advanced)",
            "type": "string",
            "description": "Name of the connector's tool to call. Leave empty: the best tool that posts a message, creates a page or appends rows is picked, and the run log lists every tool the connector offers."
          },
          "deliveryArguments": {
            "title": "Connector tool arguments (advanced)",
            "type": "object",
            "description": "Extra arguments for the tool, merged last, for example {\"channel\": \"#reddit-leads\"} or {\"parent\": {\"database_id\": \"…\"}}."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}