{
  "openapi": "3.0.1",
  "info": {
    "title": "Adobe Stock Scraper: Keywords, Contributors, Result Counts",
    "description": "Search Adobe Stock by keyword, link or contributor: one row per asset with title, keywords, contributor, type, size or duration, category, AI flag, license level and the total results of each search, for stock keyword research. No login.",
    "version": "0.1",
    "x-build-id": "zfamfPyYs5GFCPl4h"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/themineworks~adobe-stock-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-themineworks-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/themineworks~adobe-stock-scraper/runs": {
      "post": {
        "operationId": "runs-sync-themineworks-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/themineworks~adobe-stock-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-themineworks-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": "Keywords",
            "type": "array",
            "description": "Search terms, one per line, as you would type them in the Adobe Stock search box. Example: coffee, summer festival, ai robot. Each keyword is one search, and each row carries the total number of results Adobe Stock has for it. Up to 100 searches per run.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Adobe Stock links or asset numbers (optional)",
            "type": "array",
            "description": "Any mix of: search links copied from your browser (https://stock.adobe.com/search?k=coffee&..., the filters you set on the site are kept), asset links (https://stock.adobe.com/images/.../94143804, /video/..., /templates/..., /3d-assets/...) or bare asset numbers such as 94143804, and contributor profile links (https://stock.adobe.com/contributor/203434592/chayathon2000) for a whole portfolio.",
            "items": {
              "type": "string"
            }
          },
          "contentTypes": {
            "title": "Content types",
            "type": "array",
            "description": "Which kinds of assets to search. Leave empty for all six. Applies to keywords and contributor links, not to pasted search links.",
            "items": {
              "type": "string",
              "enum": [
                "photo",
                "illustration",
                "vector",
                "video",
                "template",
                "3d"
              ],
              "enumTitles": [
                "Photos",
                "Illustrations",
                "Vectors",
                "Videos",
                "Templates",
                "3D"
              ]
            }
          },
          "orientation": {
            "title": "Orientation",
            "enum": [
              "all",
              "horizontal",
              "vertical",
              "square",
              "panoramic"
            ],
            "type": "string",
            "description": "Only assets of this shape.",
            "default": "all"
          },
          "aiGenerated": {
            "title": "Generative AI",
            "enum": [
              "all",
              "exclude",
              "only"
            ],
            "type": "string",
            "description": "Keep, exclude or return only assets made with generative AI.",
            "default": "all"
          },
          "license": {
            "title": "License level",
            "enum": [
              "all",
              "standard",
              "premium",
              "free"
            ],
            "type": "string",
            "description": "Standard (core) assets, Premium assets, or the free collection. Adobe prices every video at a premium level, so Standard returns no videos.",
            "default": "all"
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "downloads",
              "newest",
              "popularity",
              "undiscovered"
            ],
            "type": "string",
            "description": "Result order. Downloads puts the best sellers first, Newest the latest uploads, Undiscovered the assets with few or no downloads yet.",
            "default": "relevance"
          },
          "maxItems": {
            "title": "Max assets per search",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "The most assets to return for each keyword, search link or contributor, 1 to 10,000 (Adobe Stock shows at most 10,000 per search). A page holds 100. Set 1 to get just the total result count of each keyword at the lowest cost.",
            "default": 100
          },
          "includeKeywords": {
            "title": "Get each asset's keywords",
            "type": "boolean",
            "description": "On: the asset page of each photo, illustration and vector is opened for its full keyword list (the tags the contributor submitted). Off: rows come from the search pages only, which is about 5 times faster. Video, template and 3D pages do not list keywords. Same price either way.",
            "default": true
          },
          "residentialFallback": {
            "title": "Retry refused search pages on residential IPs",
            "type": "boolean",
            "description": "Adobe Stock runs a bot check that sometimes refuses a datacenter IP. On: a refused search page is retried on a residential IP, so the run still returns its assets. Off: retries stay on datacenter IPs, and a run whose first page is refused three times stops with nothing charged. Same price either way.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}