{
  "openapi": "3.0.1",
  "info": {
    "title": "TikTok Profile Videos Scraper",
    "description": "Scrape public TikTok profile videos by username or URL: captions, views, likes, music, hashtags, download links. Date range and new-only monitoring. No login.",
    "version": "0.3",
    "x-build-id": "7M1eq7cm9jkLbVn90"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~tiktok-profile-videos-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-tiktok-profile-videos-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/khadinakbar~tiktok-profile-videos-scraper/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-tiktok-profile-videos-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/khadinakbar~tiktok-profile-videos-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-tiktok-profile-videos-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": {
          "profileHandles": {
            "title": "Profile Handles or URLs",
            "type": "array",
            "description": "Use this when you want videos from one or more public TikTok creator profiles. Accepts handles like nike, @nike, or full URLs like https://www.tiktok.com/@nike. Defaults to the prefilled example for testing. Not for keyword, hashtag, comment, or single-video scraping.",
            "items": {
              "type": "string"
            }
          },
          "usernames": {
            "title": "Usernames (alias)",
            "type": "array",
            "description": "Same as Profile Handles: TikTok usernames such as nike or @nike. Use either field or both; duplicates are removed. Not for keywords or hashtags.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Profile URLs",
            "type": "array",
            "description": "TikTok profile URLs such as https://www.tiktok.com/@nike. Use when you already have links instead of usernames. Video links are not accepted.",
            "items": {
              "type": "object"
            }
          },
          "maxVideosPerProfile": {
            "title": "Max Videos Per Profile",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Use this to cap how many videos are saved from each creator profile. Accepts integers from 1 to 10000. Defaults to 50 and the prefill is 10 for quick tests. This is the main per-profile billing guard.",
            "default": 50
          },
          "maxPagesPerProfile": {
            "title": "Max Pages Per Profile",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Use this as a safety cap for provider pagination on each creator feed. Accepts integers from 1 to 500. Defaults to 10 and the prefill is 1 for fast quality checks. Not a result limit by itself.",
            "default": 10
          },
          "maxTotalVideos": {
            "title": "Max Total Videos",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Use this to cap the whole run across all profile inputs. Accepts integers from 1 to 50000. Defaults to 10000 and the prefill is 50. Free Apify plans are capped at 100 videos per run. This prevents accidental overbilling on large creator batches.",
            "default": 10000
          },
          "sortBy": {
            "title": "Profile Sort Order",
            "enum": [
              "latest",
              "popular"
            ],
            "type": "string",
            "description": "Use this to request a provider-supported creator feed order. Accepted values are latest and popular. Defaults to latest. Not all providers return identical ordering for the same profile.",
            "default": "latest"
          },
          "region": {
            "title": "Region",
            "type": "string",
            "description": "Use this to localize provider requests with an alpha-2 country code. Example values are US, GB, FR, or PH. Defaults to US. This is not a language filter and does not translate captions.",
            "default": "US"
          },
          "trim": {
            "title": "Trim Provider Response",
            "type": "boolean",
            "description": "Use this to request smaller provider payloads when supported. The normalized dataset fields stay the same. Defaults to true for speed and lower memory use. Turn it off only when debugging with Include Raw Provider Data.",
            "default": true
          },
          "includeRawData": {
            "title": "Include raw response Data",
            "type": "boolean",
            "description": "Use this when you need the original provider response attached to each dataset row. It helps debug field drift or build custom parsers. Defaults to false. Not recommended for AI-agent runs because raw payloads are large.",
            "default": false
          },
          "postedAfter": {
            "title": "Posted after (date)",
            "type": "string",
            "description": "Only save videos posted on or after this date. Format YYYY-MM-DD, for example 2026-10-01. Videos older than this are skipped and not charged. Leave empty for no limit."
          },
          "postedBefore": {
            "title": "Posted before (date)",
            "type": "string",
            "description": "Only save videos posted on or before this date (the whole day counts). Format YYYY-MM-DD. Skipped videos are not charged. Leave empty for no limit."
          },
          "onlyNewVideos": {
            "title": "Only new videos since last run",
            "type": "boolean",
            "description": "Monitoring mode. When true, each profile returns only videos posted after the newest video this account saw on the previous run, so repeat runs pay only for new posts. The first run returns the latest videos as normal. Uses latest-first order. Defaults to false.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}