{
  "openapi": "3.0.1",
  "info": {
    "title": "YouTube, TikTok & Instagram Profile Videos Scraper",
    "description": "Export public videos and view counts from YouTube channels, TikTok creators, and Instagram profiles into one normalized dataset. Mix platforms in one run, cap results per profile, or stream bulk inputs from a Dataset. No login or residential proxy.",
    "version": "1.0",
    "x-build-id": "pGBtY6TmIT1Z2Bdry"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/funny_ground~social-creator-all-videos/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-funny_ground-social-creator-all-videos",
        "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/funny_ground~social-creator-all-videos/runs": {
      "post": {
        "operationId": "runs-sync-funny_ground-social-creator-all-videos",
        "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/funny_ground~social-creator-all-videos/run-sync": {
      "post": {
        "operationId": "run-sync-funny_ground-social-creator-all-videos",
        "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": {
          "profileUrls": {
            "title": "Creator profile URLs",
            "type": "array",
            "description": "YouTube channel, TikTok @profile, or Instagram profile URLs. You may mix all three platforms in one run.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "inputDatasetId": {
            "title": "Input dataset ID",
            "type": "string",
            "description": "Optional. Stream an arbitrarily large profile list from an Apify dataset. Each item should contain the field selected below."
          },
          "urlField": {
            "title": "Dataset profile URL field",
            "type": "string",
            "description": "Field containing the creator profile URL in each input dataset item.",
            "default": "url"
          },
          "maxVideosPerProfile": {
            "title": "Maximum videos per profile",
            "minimum": 0,
            "maximum": 50000,
            "type": "integer",
            "description": "0 fetches all available public videos, with a 50,000-row safety cap per profile. Set a positive number for faster samples.",
            "default": 0
          },
          "includeYouTubeShorts": {
            "title": "Include YouTube Shorts",
            "type": "boolean",
            "description": "Also paginate the channel Shorts tab and deduplicate against regular videos.",
            "default": true
          },
          "includeYouTubeStreams": {
            "title": "Include YouTube live streams",
            "type": "boolean",
            "description": "Also paginate the channel Live tab and deduplicate against other tabs.",
            "default": true
          },
          "maxConcurrency": {
            "title": "Maximum profile concurrency",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Profiles processed simultaneously. Per-platform safeguards are applied automatically.",
            "default": 8
          },
          "youtubeConcurrency": {
            "title": "YouTube concurrency",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Maximum simultaneous YouTube profiles.",
            "default": 8
          },
          "tiktokConcurrency": {
            "title": "TikTok concurrency",
            "minimum": 1,
            "maximum": 8,
            "type": "integer",
            "description": "Maximum simultaneous TikTok profiles. Requests are globally paced for reliability.",
            "default": 3
          },
          "instagramConcurrency": {
            "title": "Instagram concurrency",
            "minimum": 1,
            "maximum": 2,
            "type": "integer",
            "description": "Instagram public GraphQL uses one shared browser session; 1 is the safest setting.",
            "default": 1
          },
          "instagramRequestDelayMs": {
            "title": "Instagram request delay",
            "minimum": 100,
            "maximum": 5000,
            "type": "integer",
            "description": "Minimum spacing between public Instagram GraphQL requests.",
            "default": 350
          },
          "maxRequestRetries": {
            "title": "Request retries",
            "minimum": 0,
            "maximum": 4,
            "type": "integer",
            "description": "Retries transient network, throttling, and server errors.",
            "default": 2
          },
          "requestTimeoutSecs": {
            "title": "Request timeout",
            "minimum": 15,
            "maximum": 120,
            "type": "integer",
            "description": "Maximum time for one upstream request.",
            "default": 45
          },
          "includeFailedProfiles": {
            "title": "Include failed profiles",
            "type": "boolean",
            "description": "Write one free diagnostic row for invalid, private, unavailable, or failed profiles.",
            "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}