{
  "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": "ZQ7exXb5uck6eond2"
  },
  "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), a collection (<code>https://www.pexels.com/collections/aquatic-aesthetic-bw7dkse/</code>), the home page <code>https://www.pexels.com/</code> (its curated feed) or <code>https://www.pexels.com/videos/</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. The examples are two coffee photos and a coffee video.",
            "items": {
              "type": "string"
            }
          },
          "mediaType": {
            "title": "🖼️ Media type",
            "enum": [
              "photos",
              "videos",
              "all"
            ],
            "type": "string",
            "description": "What keywords, photographer links, collection links and the curated feed return. <b>Photos and videos</b> takes both. A search link, a photo page or a video page keeps its own type, and similar media are of the type of their photo or video.",
            "default": "photos"
          },
          "maxItems": {
            "title": "🔢 Max results per keyword, link or feed",
            "minimum": 1,
            "type": "integer",
            "description": "Stop each keyword, search link, photographer, collection, similar search and the curated feed 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
          },
          "similarTo": {
            "title": "🧲 Similar to these photos or videos",
            "type": "array",
            "description": "Photo or video ids or links, one per line: <code>27860686</code> or <code>https://www.pexels.com/photo/coffee-cup-27860686/</code>. Each one brings the media Pexels shows as similar to it (photos for a photo, videos for a video), up to <b>Max results</b> each, to grow a moodboard or a dataset around a reference. Every row says which one it is similar to.",
            "items": {
              "type": "string"
            }
          },
          "curatedFeed": {
            "title": "📰 Curated feed",
            "type": "boolean",
            "description": "Read the photos and videos Pexels' team hand-picks for its home page, newest first, no keyword needed. With <b>Videos</b> as media type, it reads the curated feed of pexels.com/videos/.",
            "default": false
          },
          "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."
          },
          "peopleCount": {
            "title": "👥 Number of people",
            "enum": [
              "any",
              "0",
              "1",
              "2",
              "3_plus"
            ],
            "type": "string",
            "description": "Keep photos and videos that show this many people: none for backgrounds and product shots, one for portraits, a group for team and lifestyle scenes.",
            "default": "any"
          },
          "minDuration": {
            "title": "⏱️ Minimum video length",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only videos at least this long, in seconds. Leave empty for any length. Photos are not affected."
          },
          "maxDuration": {
            "title": "⏱️ Maximum video length",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only videos at most this long, in seconds: <code>15</code> for social clips, <code>60</code> for B-roll. Leave empty for any length."
          },
          "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}