{
  "openapi": "3.0.1",
  "info": {
    "title": "YouTube Search Scraper — Videos by Keyword + Transcripts",
    "description": "YouTube search scraper, priced per video, no login, no cookies, no API key: type a search phrase and get one row per video — title, link, channel, handle, views, published, length, thumbnail and rank. Turn on transcripts to add each video's captions as text.",
    "version": "1.0",
    "x-build-id": "l3TNBXIzJqJkL1PnJ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/steadyfetch~youtube-search-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-steadyfetch-youtube-search-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/steadyfetch~youtube-search-scraper/runs": {
      "post": {
        "operationId": "runs-sync-steadyfetch-youtube-search-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/steadyfetch~youtube-search-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-steadyfetch-youtube-search-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 phrases",
            "type": "array",
            "description": "One search phrase per line, exactly as you would type it into YouTube's search box (\"sourdough bread\", \"how to start a podcast\"), or a pasted YouTube search results address (youtube.com/results?search_query=…) — its phrase is read for you. YouTube answers every phrase with its own results, in its own order (rank). Up to 50 searches per run. Have single video links instead? The YouTube Transcript Scraper takes video links; a whole channel goes to YouTube Channel Transcripts.",
            "items": {
              "type": "string"
            }
          },
          "searchType": {
            "title": "Search for",
            "type": "string",
            "description": "Leave empty: a run searches videos, the only kind of search on this build.",
            "default": "videos"
          },
          "maxResults": {
            "title": "Max videos per search",
            "type": "integer",
            "description": "The most videos to return for each search. A page carries about 20 videos; one search is read to at most 500 videos (25 pages) per run, and most lists end sooner. A page that brings fewer videos than one page check is worth is billed one check instead of per video.",
            "default": 20
          },
          "transcripts": {
            "title": "Add each video's transcript",
            "type": "boolean",
            "description": "Off (default): search results only, priced per video. On: each video's transcript (its captions — the uploader's own, or YouTube's automatic ones) is added to its row as plain text, with its language, and charged once per video that returns real text. A video with no captions, or one YouTube will not play without a signed-in account, gets no transcript and no transcript charge — its row says why. Transcripts take 3–5 seconds a video.",
            "default": false
          },
          "language": {
            "title": "Preferred transcript language",
            "type": "string",
            "description": "A language code like \"en\" or \"es\". When a video has captions in this language they are used; otherwise its own caption language is. Leave empty to use each video's own."
          },
          "uploadDate": {
            "title": "Uploaded within",
            "type": "string",
            "description": "Only videos uploaded within this window: today, this_week, this_month or this_year. Leave empty for any time. Any other value refuses the search (uncharged) and names the values that work."
          },
          "onlyNew": {
            "title": "Only videos I don't have yet",
            "type": "boolean",
            "description": "Off (default): every run returns the search's videos with today's views, each charged, and a video your account first bought for this search in the last 90 days carries seenBefore: true. On: videos your account first bought for the same search in the last 90 days are skipped and not charged, so a scheduled run returns only videos new to the list (a page of nothing new bills one page check).",
            "default": false
          },
          "maxEmptyPages": {
            "title": "Stop after this many pages with nothing new",
            "minimum": 1,
            "maximum": 25,
            "type": "integer",
            "description": "With \"Only videos I don't have yet\" on: a search stops after this many pages in a row that bring no new video, so a re-run that finds nothing new costs at most this many page checks. Default 3; up to 25.",
            "default": 3
          },
          "maxRunSeconds": {
            "title": "Max run seconds",
            "type": "integer",
            "description": "Stop collecting after this many seconds. Videos already collected are still delivered. Leave empty for no limit beyond the run timeout."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}