{
  "openapi": "3.0.1",
  "info": {
    "title": "Likee Scraper - Videos",
    "description": "Collect public Likee videos, featured creators, and recommended hashtags. Get captions, available counts, creator details, and media links, or review summaries of creator video histories.",
    "version": "0.0",
    "x-build-id": "AxCzeJ6YBb4RnBz8j"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/maximedupre~likee-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-maximedupre-likee-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/maximedupre~likee-scraper/runs": {
      "post": {
        "operationId": "runs-sync-maximedupre-likee-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/maximedupre~likee-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-maximedupre-likee-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": [
          "resultType"
        ],
        "properties": {
          "resultType": {
            "title": "Result type",
            "enum": [
              "videos",
              "creatorAnalysis",
              "featuredCreators",
              "trendingHashtags"
            ],
            "type": "string",
            "description": "Choose the kind of results to collect."
          },
          "onlyNewVideos": {
            "title": "Only newly observed videos",
            "type": "boolean",
            "description": "For Videos, save successful observations for the same target scope and return only videos not seen in earlier successful runs. The first run returns all matching videos. Failed lookups do not mean a video was deleted."
          },
          "creatorHistoryFromVideoLinks": {
            "title": "Creator history from video links",
            "type": "boolean",
            "description": "For Videos, collect the creator’s public video history behind each Video URL instead of just that video. Creator history analysis always reads creator histories.",
            "default": false
          },
          "hashtags": {
            "title": "Hashtags",
            "type": "array",
            "description": "For Trending hashtags, look up these names in the recommended lists for the chosen countries. Leave blank for the full recommended lists. This does not collect hashtag video feeds.",
            "items": {
              "type": "string"
            }
          },
          "videoUrls": {
            "title": "Video URLs",
            "type": "array",
            "description": "For Videos, collect each linked video. Turn on Creator history from video links to collect its creator’s videos instead. For Creator history analysis, analyze the creator behind each link.",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "title": "URL",
                  "type": "string",
                  "description": "A complete Likee URL starting with http:// or https://.",
                  "pattern": "^https?://\\S+$"
                }
              },
              "required": [
                "url"
              ]
            }
          },
          "creatorProfileUrls": {
            "title": "Creator profile URLs",
            "type": "array",
            "description": "For Videos and Creator history analysis, add complete Likee creator profile URLs.",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "title": "URL",
                  "type": "string",
                  "description": "A complete Likee URL starting with http:// or https://.",
                  "pattern": "^https?://\\S+$"
                }
              },
              "required": [
                "url"
              ]
            }
          },
          "creatorIds": {
            "title": "Creator IDs",
            "type": "array",
            "description": "For Videos and Creator history analysis, add numeric creator IDs as text to preserve every digit.",
            "items": {
              "type": "string",
              "pattern": "^[0-9]+$"
            }
          },
          "creatorHandles": {
            "title": "Creator handles",
            "type": "array",
            "description": "For Videos and Creator history analysis, add Likee handles, with or without @.",
            "items": {
              "type": "string"
            }
          },
          "posts": {
            "title": "Creator and post IDs",
            "type": "array",
            "description": "For Videos, add a creator ID and a post ID to collect a specific video. For Creator history analysis, use each pair to find the creator to analyze.",
            "items": {
              "type": "object",
              "properties": {
                "creatorId": {
                  "title": "Creator ID",
                  "type": "string",
                  "description": "The numeric ID of the video’s creator.",
                  "editor": "textfield",
                  "pattern": "^[0-9]+$"
                },
                "postId": {
                  "title": "Post ID",
                  "type": "string",
                  "description": "The source ID of the video.",
                  "editor": "textfield",
                  "minLength": 1
                }
              },
              "required": [
                "creatorId",
                "postId"
              ]
            }
          },
          "creatorFeedOrder": {
            "title": "Creator feed order",
            "enum": [
              "newest",
              "mostViewed"
            ],
            "type": "string",
            "description": "For Videos and Creator history analysis, choose which profile videos to read first. Individual video lookups do not use this choice.",
            "default": "newest"
          },
          "countryCodes": {
            "title": "Country codes",
            "type": "array",
            "description": "For Featured creators and Trending hashtags, add two-letter country codes such as US or IN. Likee may return its default recommendations when a country list is not available.",
            "items": {
              "type": "string",
              "pattern": "^[A-Za-z]{2}$"
            }
          },
          "captionText": {
            "title": "Caption contains",
            "type": "string",
            "description": "For Videos and Creator history analysis, keep videos whose captions contain this text within the submitted creators’ histories. This is not a search across all Likee videos."
          },
          "publishedAfter": {
            "title": "Published on or after",
            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
            "type": "string",
            "description": "For Videos and Creator history analysis. Keep videos published on or after this date, in UTC."
          },
          "publishedBefore": {
            "title": "Published on or before",
            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
            "type": "string",
            "description": "For Videos and Creator history analysis. Keep videos published on or before this date, in UTC."
          },
          "minViews": {
            "title": "Minimum views",
            "minimum": 0,
            "type": "integer",
            "description": "For Videos and Creator history analysis, keep videos with at least this many views. A missing source count does not pass this filter."
          },
          "minLikes": {
            "title": "Minimum likes",
            "minimum": 0,
            "type": "integer",
            "description": "For Videos and Creator history analysis, keep videos with at least this many likes. A missing source count does not pass this filter."
          },
          "minComments": {
            "title": "Minimum comments",
            "minimum": 0,
            "type": "integer",
            "description": "For Videos and Creator history analysis, keep videos with at least this many comments. A missing source count does not pass this filter."
          },
          "minShares": {
            "title": "Minimum shares",
            "minimum": 0,
            "type": "integer",
            "description": "For Videos and Creator history analysis, keep videos with at least this many shares. A missing source count does not pass this filter."
          },
          "minEngagementRate": {
            "title": "Minimum engagement rate (%)",
            "minimum": 0,
            "type": "number",
            "description": "For Videos and Creator history analysis, keep videos where (likes + comments + shares) / views × 100 meets this value. Missing counts or zero views do not pass this filter."
          },
          "minFollowers": {
            "title": "Minimum creator followers",
            "minimum": 0,
            "type": "integer",
            "description": "For Videos, Creator history analysis and Featured creators, keep creators with at least this many source followers. A missing count does not pass this filter."
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 1,
            "type": "integer",
            "description": "Optional stop after this many result rows across the run. Leave blank for all available results until the source is exhausted. For Creator history analysis, each row is one creator summary that reports the history successfully read."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}