{
  "openapi": "3.0.1",
  "info": {
    "title": "TikTok Profile Scraper (Pay Per Result)",
    "description": "Get TikTok user info and profile data by username: followers, likes, bio, link, verified badge, TikTok Shop seller data and latest posts. One row per handle, even for missing accounts; up to 1,000 per run. Input and output compatible with TikTok profile scrapers. No login or proxies. Pay per result.",
    "version": "0.1",
    "x-build-id": "jeFt7oMfZEIMVKOZ9"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/xmolodtsov~tiktok-profile-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-xmolodtsov-tiktok-profile-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/xmolodtsov~tiktok-profile-scraper/runs": {
      "post": {
        "operationId": "runs-sync-xmolodtsov-tiktok-profile-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/xmolodtsov~tiktok-profile-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-xmolodtsov-tiktok-profile-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",
        "required": [
          "profiles"
        ],
        "properties": {
          "profiles": {
            "title": "TikTok profiles",
            "minItems": 1,
            "maxItems": 1000,
            "type": "array",
            "description": "TikTok usernames to scrape: bare handles (<code>nasa</code>), <code>@handle</code> or full profile URLs (<code>https://www.tiktok.com/@nasa</code>). Up to 1,000 per run; duplicates are removed. Every handle gets exactly one row, even when the profile doesn't exist. On the free Apify plan only the first 10 profiles are scraped.",
            "items": {
              "type": "string"
            }
          },
          "resultsPerPage": {
            "title": "Posts per profile",
            "minimum": 0,
            "maximum": 3000,
            "type": "integer",
            "description": "How many latest posts to return per profile. Each post is one paid result and carries the full author block (<code>authorMeta</code>).<br><br><strong>Set to 0 for profile-only mode:</strong> one compact item per handle with just the author block — the cheapest way to get profile metadata.<br><br>On the free Apify plan this is capped at 1 post per profile."
          },
          "oldestPostDate": {
            "title": "Oldest post date",
            "type": "string",
            "description": "Only return posts created on/after this date (ISO format, e.g. <code>2024-01-01</code>). Leave empty for no date filter; invalid dates are ignored."
          },
          "newestPostDate": {
            "title": "Newest post date",
            "type": "string",
            "description": "Only return posts created on/before this date. A date-only value (YYYY-MM-DD) includes the whole UTC day through 23:59:59.999; a full ISO timestamp is exact. Leave empty for no upper bound; invalid dates are ignored with a warning. Free on all plans."
          },
          "excludePinnedPosts": {
            "title": "Exclude pinned posts",
            "type": "boolean",
            "description": "If enabled, pinned posts are filtered out of the results.",
            "default": false
          },
          "includeTranscript": {
            "title": "Native captions",
            "type": "boolean",
            "description": "Opt-in, paid add-on, not available on the free plan. Native TikTok captions only, ~44–63% of posts have them (no speech recognition). Adds transcript: {lang, source, text} to post rows; missing or failed captions are null and not charged. Text is capped at 100,000 characters. Launching soon / charged only when listed in the Actor pricing.",
            "default": false
          },
          "commentsPerPost": {
            "title": "Comments per post",
            "minimum": 0,
            "maximum": 200,
            "type": "integer",
            "description": "Opt-in, paid add-on, not available on the free plan. Up to 200 top-level comments per post in commentList[], with replies[]. 0 disables it. Each delivered comment or reply is one comment event. Launching soon / charged only when listed in the Actor pricing.",
            "default": 0
          },
          "maxRepliesPerComment": {
            "title": "Replies per comment",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "Opt-in, paid add-on, not available on the free plan. Up to 10 replies per comment; requires commentsPerPost > 0. 0 disables replies. Each delivered reply is one comment event. Launching soon / charged only when listed in the Actor pricing.",
            "default": 0
          },
          "downloadVideos": {
            "title": "Download videos",
            "type": "boolean",
            "description": "Opt-in, paid add-on, not available on the free plan. Launching soon: charged only when the video events are listed in the Actor pricing. Fetch each eligible video page through the built-in datacenter pool, then save MP4 files directly from the CDN in the run’s key-value store and attach videoFile metadata (null when unavailable). Charged only after successful storage, for the delivered class. Files above 64 MB are skipped. Storage follows your Apify KV retention.",
            "default": false
          },
          "videoQuality": {
            "title": "Video quality",
            "enum": [
              "540p",
              "720p",
              "1080p"
            ],
            "type": "string",
            "description": "Opt-in, paid add-on, not available on the free plan. Launching soon: charged only when the video events are listed in the Actor pricing. Used with downloadVideos. Select the smallest file in this resolution class (shorter dimension); if missing, try the next lower priced class. Charge only the delivered class as video-download-540p, video-download-720p or video-download-1080p. Codecs may include HEVC; no transcoding.",
            "default": "540p"
          },
          "profileScrapeSections": {
            "title": "Profile sections",
            "type": "array",
            "description": "Which profile sections to scrape. Only <code>videos</code> is supported.",
            "items": {
              "type": "string",
              "enum": [
                "videos"
              ],
              "enumTitles": [
                "Videos"
              ]
            },
            "default": [
              "videos"
            ]
          },
          "profileSorting": {
            "title": "Post sorting",
            "enum": [
              "latest"
            ],
            "type": "string",
            "description": "Order of returned posts. Posts are returned newest-first (<code>latest</code>).",
            "default": "latest"
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional override. By default the actor uses its own built-in proxy pool — you don't need to configure anything."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}