{ "openapi": "3.0.1", "info": { "title": "Lemon8 Scraper", "description": "Scrape public Lemon8 posts from post URLs, full creator profiles, keyword search, hashtags and category feeds: title, text, images, video, hashtags, likes, saves, comments, views, date and creator followers. No login. US$ 2.50 per 1,000 posts.", "version": "0.1", "x-build-id": "p3dAfAhchq4QW6ptS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapewise~lemon8-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapewise-lemon8-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/scrapewise~lemon8-scraper/runs": { "post": { "operationId": "runs-sync-scrapewise-lemon8-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/scrapewise~lemon8-scraper/run-sync": { "post": { "operationId": "run-sync-scrapewise-lemon8-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": { "urls": { "title": "Lemon8 URLs", "type": "array", "description": "One per line. Profile (https://www.lemon8-app.com/@lemon8_us or @lemon8_us) returns the creator's posts, newest first. Post (https://www.lemon8-app.com/@user/7460605475378283050) returns that post. Also accepts hashtag URLs (/topic/), keyword URLs (/discover/ or /experience/) and category feeds (/feed/fashion).", "items": { "type": "string" } }, "keywords": { "title": "Search keywords", "type": "array", "description": "Keywords to search on Lemon8, one per line (for example: skincare routine, easy recipes, summer outfits). Each keyword returns up to 'Max items' posts.", "items": { "type": "string" } }, "hashtags": { "title": "Hashtags", "type": "array", "description": "Hashtags with or without # (fitinspo, #skincare). Each hashtag returns up to 'Max items' posts from its public feed, popular first and then most recent.", "items": { "type": "string" } }, "feedCategories": { "title": "Category feeds", "type": "array", "description": "Lemon8 category feeds, one per line: foryou, fashion, beauty, food, wellness, travel, home, pets, relationship, tech, career, reading, fitness. Each category returns up to 'Max items' posts.", "items": { "type": "string" } }, "region": { "title": "Region", "enum": [ "us", "uk", "ca", "au", "nz", "jp", "th", "id", "vn", "my", "sg", "ph" ], "type": "string", "description": "Lemon8 market used for keyword search, hashtags and category feeds. A region inside a URL (?region=jp) wins for that URL. Posts and profiles open from any region.", "default": "us" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum posts per profile, keyword, hashtag or category. Post URLs are always returned in full.", "default": 30 }, "includePostDetails": { "title": "Full post details", "type": "boolean", "description": "Opens each post to add publish date, views, saves, comment count, full text, every image, video link and the creator's followers. One extra light request per post, same price. Turn off for a faster list with title, cover, likes and creator only.", "default": true }, "searchHashtagFallback": { "title": "Deepen keyword search with the matching hashtag", "type": "boolean", "description": "Lemon8's web search shows 5 to 60 posts per keyword. When on, a keyword that runs out continues with the hashtag of the same name (for example 'easy recipes' continues with #easyrecipes) until 'Max items'. Those rows have source 'search-hashtag:'.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy is the default and works for Lemon8. Blocked requests are retried on a new IP, with residential proxy as a last resort.", "default": { "useApifyProxy": true } } } }, "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 } } }, "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 } } } } } } } } } }