# Upscrolled Post Scraper (`kada/upscrolled-post-scraper`) Actor

Scrapes upscrolled posts information. Supports posts with text, images and videos (all type of posts). Also, it extracts creator information (name, username, profile pic, etc..) and post stats (likes, comments, reposts with published date) with available metadata

- **URL**: https://apify.com/kada/upscrolled-post-scraper.md
- **Developed by:** [soulaimane kada](https://apify.com/kada) (community)
- **Categories:** Automation, Social media, Integrations
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $9.50 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## UpScrolled Post Scraper

UpScrolled Post Scraper is a tool that extracts all post information. It supports posts with text, images, and videos (all types of posts). It also extracts creator information (name, username, profile picture, etc.) and post stats (likes, comments, reposts, and published date), along with available metadata.

The UpScrolled Post Scraper allows you to scrape posts from the UpScrolled app. It supports all types of posts (videos, images, and text-only posts) when a link to an UpScrolled post is provided.

This unofficial UpScrolled API is designed to let you scrape posts easily and retrieve metadata with no limits and no login required. Use it to download videos with no watermark, images, or post text.

### Features

- **Video Posts** → Extract video URL + metadata  
- **Image Posts** → Extract image URL + metadata  
- **Text Posts** → Extract text content only + metadata

### How to Use This API

#### Input Parameters

The input for this scraper should be a JSON object containing the URL of the target post you want to scrape. Check the input tab for a detailed list of parameters.

```json
{
  "url": "https://share.upscrolled.com/en/post/a5749c70-0671-11f1-8080-80001ac98058"
}
````

### UpScrolled Output Format

After a successful request, the API will return the post data.

#### Scraped UpScrolled Post

The structure of each item in an UpScrolled post looks like this:

#### Post contains a video:

```json
{
  "success": true,
  "results": {
    "activity": {
      "id": "a5749c70-0671-11f1-8080-80001ac98058",
      "time": "2026-02-10T11:14:20.215000",
      "text": "Straight from our Founder & CEO @Issam - here's how we're taking action against harmful content and putting user safety at the heart of everything we build. Your safety matters to us.",
      "postType": "VIDEO",
      "attachments": [
        {
          "type": "video",
          "url": "https://stream.prod-ext.video.upscrolled.com/6k36y7uzQ7bV00xCQDoThL1XlrvSBZ1rh5AeONSWgZMM.m3u8",
          "aspectRatio": 0.5625,
          "thumbnailUrl": "https://image.prod-ext.video.upscrolled.com/6k36y7uzQ7bV00xCQDoThL1XlrvSBZ1rh5AeONSWgZMM/thumbnail.jpg"
        }
      ],
      "actor": {
        "name": "UpScrolled",
        "handle": "UpScrolled",
        "profileImage": "https://d2sscsmkqn4j9v.cloudfront.net/6ce22610-7218-4824-a29f-d1e5dd50357b/ProfileImage_10ffdb15-c5fd-4e46-9a7e-195196f57ea1.jpg",
        "isVerified": true,
        "isActive": true,
        "isPrivate": false
      },
      "reactionCounts": {
        "likes": 19580,
        "comments": 2342,
        "reposts": 2315
      },
      "isRestricted": false,
      "isNestedRestricted": false,
      "isRepost": false,
      "original": null
    }
  }
}
```

#### Post contains an image:

```json
{
  "success": true,
  "results": {
    "activity": {
      "id": "4de09d80-2447-11f1-8080-8001490e5823",
      "time": "2026-03-20T10:26:49.304000",
      "text": "From my family to yours, Eid Mubarak to everyone celebrating",
      "postType": "PHOTO",
      "attachments": [
        {
          "type": "image",
          "url": "https://d2sscsmkqn4j9v.cloudfront.net/0a63ec2d-cd86-4a84-8bf1-14a4f25665fb/Image_9315ee71-8653-4963-9cd6-9725db95f458.jpg",
          "aspectRatio": null,
          "thumbnailUrl": null
        }
      ],
      "actor": {
        "name": "Abier",
        "handle": "AbierKhatib",
        "profileImage": "https://d2sscsmkqn4j9v.cloudfront.net/0a63ec2d-cd86-4a84-8bf1-14a4f25665fb/ProfileImage_b7d69bfa-ae41-4507-90c5-852f163009cc.jpg",
        "isVerified": true,
        "isActive": true,
        "isPrivate": false
      },
      "reactionCounts": {
        "likes": 220,
        "comments": 21,
        "reposts": 13
      },
      "isRestricted": false,
      "isNestedRestricted": false,
      "isRepost": false,
      "original": null
    }
  }
}
```

#### Post contains a text-only:

```json
{
  "success": true,
  "results": {
    "activity": {
      "id": "29f60a50-fd40-11f0-8080-800053d811cb",
      "time": "2026-01-29T18:27:27.221000",
      "text": "Some of my favorite Palestine, commentary, and news creators:\n@guy\n@AnaKasparian\n@MelTheVCL\n@AbierKhatib\n@ErikWarsaw\n@SuppressedNws1\n@gregjstoker\n@IsraelExposed\n@myzfrancois\n\nSomeone close to me who enjoys posting videos running with his dog:\n@hattmoss",
      "postType": "TEXT",
      "attachments": [],
      "actor": {
        "name": "Wally Rashid",
        "handle": "wallyrashid",
        "profileImage": "https://d2sscsmkqn4j9v.cloudfront.net/de5941d0-206c-48a6-a7b7-226aa2afc437/ProfileImage_408b4dbc-edc2-4fd2-bb66-5f917c733139.jpg",
        "isVerified": true,
        "isActive": true,
        "isPrivate": false
      },
      "reactionCounts": {
        "likes": 666,
        "comments": 78,
        "reposts": 171
      },
      "isRestricted": false,
      "isNestedRestricted": false,
      "isRepost": false,
      "original": null
    }
  }
}
```

#### Your feedback

We’re always working on improving the performance of our Actors. So if you’ve got any technical feedback for upscrolled post scraper or simply found a bug, please create an issue on the Actor’s Issues tab in Apify Console.

# Actor input Schema

## `url` (type: `string`):

Upscrolled post URL to scrape

## Actor input object example

```json
{
  "url": "https://share.upscrolled.com/en/post/a5749c70-0671-11f1-8080-80001ac98058"
}
```

# Actor output Schema

## `success` (type: `string`):

Whether the request succeeded

## `results` (type: `string`):

Extracted post content (text, images, videos, metadata)

## `message` (type: `string`):

Error message if success is false

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "url": "https://share.upscrolled.com/en/post/a5749c70-0671-11f1-8080-80001ac98058"
};

// Run the Actor and wait for it to finish
const run = await client.actor("kada/upscrolled-post-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "url": "https://share.upscrolled.com/en/post/a5749c70-0671-11f1-8080-80001ac98058" }

# Run the Actor and wait for it to finish
run = client.actor("kada/upscrolled-post-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "url": "https://share.upscrolled.com/en/post/a5749c70-0671-11f1-8080-80001ac98058"
}' |
apify call kada/upscrolled-post-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=kada/upscrolled-post-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Upscrolled Post Scraper",
        "description": "Scrapes upscrolled posts information. Supports posts with text, images and videos (all type of posts). Also, it extracts creator information (name, username, profile pic, etc..) and post stats (likes, comments, reposts with published date) with available metadata",
        "version": "0.0",
        "x-build-id": "dzrg6ZWhEvJGAPegQ"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/kada~upscrolled-post-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-kada-upscrolled-post-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/kada~upscrolled-post-scraper/runs": {
            "post": {
                "operationId": "runs-sync-kada-upscrolled-post-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/kada~upscrolled-post-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-kada-upscrolled-post-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": [
                    "url"
                ],
                "properties": {
                    "url": {
                        "title": "Post URL",
                        "type": "string",
                        "description": "Upscrolled post URL to scrape"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```