{
  "openapi": "3.0.1",
  "info": {
    "title": "Likee Scraper · Profiles, Videos, MP4 & Top Creators [No Login]",
    "description": "Scrape Likee creators and their videos with exact views, likes, comments and shares, engagement rate, hashtags, sound and post date. Share links add the direct .mp4. Discover top creators and trending hashtags by country, monitor profiles for new videos. No login.",
    "version": "0.0",
    "x-build-id": "qiWWuaiAcFmpWXDYa"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~likee-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-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/memo23~likee-scraper/runs": {
      "post": {
        "operationId": "runs-sync-memo23-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/memo23~likee-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-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",
        "properties": {
          "startUrls": {
            "title": "Likee links or names",
            "type": "array",
            "description": "One per line. Accepted: a profile link (https://likee.video/@name), a bare name (name or @name), a video link (https://likee.video/@name/video/7575905643698432274), the short form name/7575905643698432274, or a share link from the app (https://l.likee.video/v/sepkYQ). Share links also return the direct .mp4 file.",
            "items": {
              "type": "string"
            }
          },
          "maxVideosPerProfile": {
            "title": "Videos per profile",
            "minimum": 0,
            "type": "integer",
            "description": "How many videos to return from each profile. 0 = every video on the profile. Large creators have over 1,000.",
            "default": 30
          },
          "videoSort": {
            "title": "Which videos first",
            "enum": [
              "latest",
              "mostViewed"
            ],
            "type": "string",
            "description": "Newest first follows the profile feed. Most viewed reads up to the 1,000 newest videos of each profile and returns the top ones by views.",
            "default": "latest"
          },
          "includeProfileRow": {
            "title": "Add a profile row",
            "type": "boolean",
            "description": "One row per profile with followers, following, total likes, level, bio, verified badge and avatar.",
            "default": true
          },
          "includeCreatorSummary": {
            "title": "Add a creator analytics row",
            "type": "boolean",
            "description": "One extra row per profile computed over the videos read: average and median views, average likes, comments and shares, average engagement rate, posts per week, views per follower and the best video. Filters do not distort it.",
            "default": false
          },
          "onlyNewVideos": {
            "title": "Only videos posted since the last run",
            "type": "boolean",
            "description": "Monitor mode. The first run returns videos as usual and remembers the newest one per profile; later runs return only videos posted after it. Run it on a schedule and pay only for what is new.",
            "default": false
          },
          "publishedAfter": {
            "title": "Posted on or after",
            "type": "string",
            "description": "Only videos posted on or after this date, e.g. 2026-01-01."
          },
          "publishedBefore": {
            "title": "Posted on or before",
            "type": "string",
            "description": "Only videos posted on or before this date, e.g. 2026-10-01."
          },
          "minViews": {
            "title": "Minimum views",
            "minimum": 0,
            "type": "integer",
            "description": "Skip videos with fewer views. Skipped videos are never written and never charged.",
            "default": 0
          },
          "minLikes": {
            "title": "Minimum likes",
            "minimum": 0,
            "type": "integer",
            "description": "Skip videos with fewer likes.",
            "default": 0
          },
          "minComments": {
            "title": "Minimum comments",
            "minimum": 0,
            "type": "integer",
            "description": "Skip videos with fewer comments.",
            "default": 0
          },
          "minShares": {
            "title": "Minimum shares",
            "minimum": 0,
            "type": "integer",
            "description": "Skip videos with fewer shares.",
            "default": 0
          },
          "minEngagementRate": {
            "title": "Minimum engagement rate (%)",
            "minimum": 0,
            "type": "integer",
            "description": "Skip videos whose (likes + comments + shares) / views is below this percentage.",
            "default": 0
          },
          "discoverCountries": {
            "title": "Top creators in these countries",
            "type": "array",
            "description": "Two-letter country codes (US, RU, IN, ID, PK, BR...). Returns Likee's top creators for each country as profile rows, ranked.",
            "items": {
              "type": "string"
            }
          },
          "maxCreatorsPerCountry": {
            "title": "Creators per country",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "How many top creators to return per country (Likee lists up to 100).",
            "default": 20
          },
          "videosPerDiscoveredCreator": {
            "title": "Videos per discovered creator",
            "minimum": 0,
            "type": "integer",
            "description": "Also return this many recent videos of each discovered creator. 0 = profile rows only.",
            "default": 0
          },
          "trendingHashtagCountries": {
            "title": "Trending hashtags in these countries",
            "type": "array",
            "description": "Two-letter country codes. Returns the hashtag challenges Likee promotes in each country, with total views and post counts. Likee promotes them only in some markets (US, GB, DE, FR, TR, UA, KZ, SA, AE and others); a country without any returns nothing and costs nothing.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max rows",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many rows in total (videos, profiles, analytics and hashtag rows). Keeps the cost of a run predictable.",
            "default": 1000
          },
          "proxy": {
            "title": "Proxy",
            "type": "object",
            "description": "Not needed: the scraper picks its own route and switches to residential IPs by itself when Likee refuses one. Set a proxy only if you want your own."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}