{
  "openapi": "3.0.1",
  "info": {
    "title": "Pexels Scraper | Photos, Videos and Download Stats",
    "description": "Pexels scraper for free stock photos and videos: 20 photos in 7 seconds, 48 fields each, from a keyword, a Pexels link or an id. Get title, tags, photographer, size, colors, views, downloads, likes, camera data, place, dates and download links, with orientation and color filters. No API key.",
    "version": "1.0",
    "x-build-id": "0WaXB3bcZVMRVuATP"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~pexels-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-pexels-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/silentflow~pexels-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-pexels-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/silentflow~pexels-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-pexels-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",
            "type": "array",
            "description": "Words you would type in the Pexels search bar, one per line: <code>coffee</code>, <code>mountain lake</code>, <code>office team</code>. Each keyword is its own search, capped by <b>Max results</b>. Pexels shows 480 results per search; past that the run keeps going through the orientations and sizes you left open (1,000 unique coffee photos on our test run).",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 Pexels links",
            "type": "array",
            "description": "Paste any pexels.com link: a search page with its filters (<code>https://www.pexels.com/search/coffee/?orientation=landscape</code>), a photo or video page, a photographer's profile (<code>https://www.pexels.com/@ekaterina-bolovtsova/</code>, all of their portfolio) or a collection (<code>https://www.pexels.com/collections/aquatic-aesthetic-bw7dkse/</code>). Image file links from images.pexels.com work too.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "mediaIds": {
            "title": "🆔 Photo or video ids",
            "type": "array",
            "description": "The number at the end of a Pexels page, one per line: <code>27860686</code> for <code>pexels.com/photo/coffee-cup-27860686/</code>. Each id gives one row, photo or video, with its full data.",
            "items": {
              "type": "string"
            }
          },
          "mediaType": {
            "title": "🖼️ Media type",
            "enum": [
              "photos",
              "videos",
              "all"
            ],
            "type": "string",
            "description": "What keywords, photographer links and collection links return. <b>Photos and videos</b> takes both in turn. A search link, a photo page or a video page keeps its own type.",
            "default": "photos"
          },
          "maxItems": {
            "title": "🔢 Max results per keyword or link",
            "minimum": 1,
            "type": "integer",
            "description": "Stop each keyword, search link, photographer or collection after this many rows. 20 photos with all their data take about 5 seconds. Ids are always read in full. Set it to what you need, the cost grows with it.",
            "default": 100
          },
          "orientation": {
            "title": "📐 Orientation",
            "enum": [
              "any",
              "landscape",
              "portrait",
              "square"
            ],
            "type": "string",
            "description": "Keep only horizontal, vertical or square media. Leave on <b>Any</b> to get the most results.",
            "default": "any"
          },
          "size": {
            "title": "📏 Minimum size",
            "enum": [
              "any",
              "large",
              "medium",
              "small"
            ],
            "type": "string",
            "description": "Keep only media of at least this resolution: <b>Large</b> is 24 megapixels or 4K video, <b>Medium</b> 12 megapixels or Full HD, <b>Small</b> 4 megapixels or HD.",
            "default": "any"
          },
          "color": {
            "title": "🎨 Color",
            "type": "string",
            "description": "Keep media whose palette matches a color. Pick one of the Pexels colors, or type a hex code such as <code>#2563eb</code> to match a brand color. Leave empty for any color."
          },
          "includeDetails": {
            "title": "📊 Views, downloads, likes and camera data",
            "type": "boolean",
            "description": "Add to each row its views, downloads and likes, and for photos the camera, lens settings (aperture, focal length, ISO, shutter speed), file size, place and content ratings. Turn it off for faster runs with search data only.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}