{
  "openapi": "3.0.1",
  "info": {
    "title": "Likee Scraper - Profiles, Videos, Creators & Hashtags",
    "description": "Scrape Likee profiles, videos with exact views, likes, comments and shares, MP4 links, creator discovery and trending hashtags. Export CSV, Excel, JSON or XML.",
    "version": "0.1",
    "x-build-id": "y6ACe5FBDeoImAhVz"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/parseforge~likee-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-parseforge-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/parseforge~likee-scraper/runs": {
      "post": {
        "operationId": "runs-sync-parseforge-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/parseforge~likee-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-parseforge-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": {
          "usernames": {
            "title": "Profiles (usernames or links)",
            "type": "array",
            "description": "Likee creators to scrape: a profile link (https://likee.video/@itz.danila), an @handle or a plain username. Each one returns a profile row plus the newest videos with exact views, likes, comments and shares.",
            "items": {
              "type": "string"
            }
          },
          "videoUrls": {
            "title": "Video URLs",
            "type": "array",
            "description": "Single videos: share links (https://likee.video/v/sepkYQ or https://l.likee.video/v/oaoej1) return the direct MP4, duration and caption; post links (https://likee.video/@user/video/<postId>) or user/postId are matched against the creator's newest videos.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max Items",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
          },
          "maxVideosPerProfile": {
            "title": "Max videos per profile",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Newest videos to collect from each profile (0 = profile row only). Likee returns videos newest first.",
            "default": 30
          },
          "includeProfileRows": {
            "title": "Add a profile row per creator",
            "type": "boolean",
            "description": "Adds one row per creator with followers, following, total likes, bio, level, badge, external link and social accounts.",
            "default": true
          },
          "exactStatsLookupPages": {
            "title": "Exact stats lookup pages",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "A share page only shows rounded counters (84.83K). The Actor looks for the same post in the creator's newest videos (100 per page) to replace them with exact numbers. 0 turns the lookup off.",
            "default": 2
          },
          "discoverCountries": {
            "title": "Discover creators in countries",
            "type": "array",
            "description": "Likee's recommended creators for each selected country (up to 100 per country), one profile row each.",
            "items": {
              "type": "string",
              "enum": [
                "US",
                "GB",
                "CA",
                "AU",
                "DE",
                "FR",
                "IT",
                "ES",
                "NL",
                "PL",
                "RO",
                "CZ",
                "SE",
                "NO",
                "FI",
                "DK",
                "GR",
                "HU",
                "BG",
                "RS",
                "HR",
                "MD",
                "RU",
                "UA",
                "BY",
                "KZ",
                "UZ",
                "KG",
                "TJ",
                "AZ",
                "AM",
                "GE",
                "TR",
                "IN",
                "ID",
                "PK",
                "BD",
                "NP",
                "SG",
                "EG",
                "SA",
                "AE",
                "IQ",
                "JO",
                "KW",
                "QA",
                "OM",
                "BH",
                "LB",
                "MA",
                "DZ",
                "TN",
                "LY",
                "SY",
                "YE",
                "MX",
                "AR",
                "CO",
                "PE",
                "CL",
                "VE",
                "EC",
                "BR",
                "PT",
                "VN",
                "TH",
                "PH",
                "MY",
                "ZA",
                "NG",
                "KE"
              ],
              "enumTitles": [
                "United States (US)",
                "United Kingdom (GB)",
                "Canada (CA)",
                "Australia (AU)",
                "Germany (DE)",
                "France (FR)",
                "Italy (IT)",
                "Spain (ES)",
                "Netherlands (NL)",
                "Poland (PL)",
                "Romania (RO)",
                "Czechia (CZ)",
                "Sweden (SE)",
                "Norway (NO)",
                "Finland (FI)",
                "Denmark (DK)",
                "Greece (GR)",
                "Hungary (HU)",
                "Bulgaria (BG)",
                "Serbia (RS)",
                "Croatia (HR)",
                "Moldova (MD)",
                "Russia (RU)",
                "Ukraine (UA)",
                "Belarus (BY)",
                "Kazakhstan (KZ)",
                "Uzbekistan (UZ)",
                "Kyrgyzstan (KG)",
                "Tajikistan (TJ)",
                "Azerbaijan (AZ)",
                "Armenia (AM)",
                "Georgia (GE)",
                "Turkey (TR)",
                "India (IN)",
                "Indonesia (ID)",
                "Pakistan (PK)",
                "Bangladesh (BD)",
                "Nepal (NP)",
                "Singapore (SG)",
                "Egypt (EG)",
                "Saudi Arabia (SA)",
                "United Arab Emirates (AE)",
                "Iraq (IQ)",
                "Jordan (JO)",
                "Kuwait (KW)",
                "Qatar (QA)",
                "Oman (OM)",
                "Bahrain (BH)",
                "Lebanon (LB)",
                "Morocco (MA)",
                "Algeria (DZ)",
                "Tunisia (TN)",
                "Libya (LY)",
                "Syria (SY)",
                "Yemen (YE)",
                "Mexico (MX)",
                "Argentina (AR)",
                "Colombia (CO)",
                "Peru (PE)",
                "Chile (CL)",
                "Venezuela (VE)",
                "Ecuador (EC)",
                "Brazil (BR)",
                "Portugal (PT)",
                "Vietnam (VN)",
                "Thailand (TH)",
                "Philippines (PH)",
                "Malaysia (MY)",
                "South Africa (ZA)",
                "Nigeria (NG)",
                "Kenya (KE)"
              ]
            }
          },
          "maxCreatorsPerCountry": {
            "title": "Max creators per country",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "How many recommended creators to take per country (Likee lists at most 100).",
            "default": 20
          },
          "videosPerDiscoveredCreator": {
            "title": "Videos per discovered creator",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Also collect this many newest videos from each discovered creator (0 = profiles only).",
            "default": 0
          },
          "trendingHashtagCountries": {
            "title": "Trending hashtags in countries",
            "type": "array",
            "description": "Likee's recommended hashtags for each selected country, with total plays and number of posts.",
            "items": {
              "type": "string",
              "enum": [
                "US",
                "GB",
                "CA",
                "AU",
                "DE",
                "FR",
                "IT",
                "ES",
                "NL",
                "PL",
                "RO",
                "CZ",
                "SE",
                "NO",
                "FI",
                "DK",
                "GR",
                "HU",
                "BG",
                "RS",
                "HR",
                "MD",
                "RU",
                "UA",
                "BY",
                "KZ",
                "UZ",
                "KG",
                "TJ",
                "AZ",
                "AM",
                "GE",
                "TR",
                "IN",
                "ID",
                "PK",
                "BD",
                "NP",
                "SG",
                "EG",
                "SA",
                "AE",
                "IQ",
                "JO",
                "KW",
                "QA",
                "OM",
                "BH",
                "LB",
                "MA",
                "DZ",
                "TN",
                "LY",
                "SY",
                "YE",
                "MX",
                "AR",
                "CO",
                "PE",
                "CL",
                "VE",
                "EC",
                "BR",
                "PT",
                "VN",
                "TH",
                "PH",
                "MY",
                "ZA",
                "NG",
                "KE"
              ],
              "enumTitles": [
                "United States (US)",
                "United Kingdom (GB)",
                "Canada (CA)",
                "Australia (AU)",
                "Germany (DE)",
                "France (FR)",
                "Italy (IT)",
                "Spain (ES)",
                "Netherlands (NL)",
                "Poland (PL)",
                "Romania (RO)",
                "Czechia (CZ)",
                "Sweden (SE)",
                "Norway (NO)",
                "Finland (FI)",
                "Denmark (DK)",
                "Greece (GR)",
                "Hungary (HU)",
                "Bulgaria (BG)",
                "Serbia (RS)",
                "Croatia (HR)",
                "Moldova (MD)",
                "Russia (RU)",
                "Ukraine (UA)",
                "Belarus (BY)",
                "Kazakhstan (KZ)",
                "Uzbekistan (UZ)",
                "Kyrgyzstan (KG)",
                "Tajikistan (TJ)",
                "Azerbaijan (AZ)",
                "Armenia (AM)",
                "Georgia (GE)",
                "Turkey (TR)",
                "India (IN)",
                "Indonesia (ID)",
                "Pakistan (PK)",
                "Bangladesh (BD)",
                "Nepal (NP)",
                "Singapore (SG)",
                "Egypt (EG)",
                "Saudi Arabia (SA)",
                "United Arab Emirates (AE)",
                "Iraq (IQ)",
                "Jordan (JO)",
                "Kuwait (KW)",
                "Qatar (QA)",
                "Oman (OM)",
                "Bahrain (BH)",
                "Lebanon (LB)",
                "Morocco (MA)",
                "Algeria (DZ)",
                "Tunisia (TN)",
                "Libya (LY)",
                "Syria (SY)",
                "Yemen (YE)",
                "Mexico (MX)",
                "Argentina (AR)",
                "Colombia (CO)",
                "Peru (PE)",
                "Chile (CL)",
                "Venezuela (VE)",
                "Ecuador (EC)",
                "Brazil (BR)",
                "Portugal (PT)",
                "Vietnam (VN)",
                "Thailand (TH)",
                "Philippines (PH)",
                "Malaysia (MY)",
                "South Africa (ZA)",
                "Nigeria (NG)",
                "Kenya (KE)"
              ]
            }
          },
          "minViews": {
            "title": "Minimum views",
            "minimum": 0,
            "type": "integer",
            "description": "Skip videos with fewer views."
          },
          "minLikes": {
            "title": "Minimum likes",
            "minimum": 0,
            "type": "integer",
            "description": "Skip videos with fewer likes."
          },
          "publishedAfter": {
            "title": "Published after",
            "type": "string",
            "description": "Only videos published on or after this date (YYYY-MM-DD)."
          },
          "publishedBefore": {
            "title": "Published before",
            "type": "string",
            "description": "Only videos published on or before this date (YYYY-MM-DD)."
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Apify proxy settings.",
            "default": {
              "useApifyProxy": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}