# OK.RU People Scraper 🔍 (`easyapi/ok-ru-people-scraper`)

Scrape user profiles from OK.RU (Odnoklassniki) social network based on keywords. Extract detailed user information including profile data, photos, and social metrics with high accuracy and stealth capabilities.

- **URL**: https://beta-securitybyobscurity.apify.com/easyapi/ok-ru-people-scraper.md
- **Developed by:** [EasyApi](https://beta-securitybyobscurity.apify.com/easyapi) (community)
- **Categories:** Social media, Integrations, Other
- **Stats:** 28 total users, 3 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: No ratings yet

## Pricing

$19.99/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.
You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

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

# README

## OK.RU People Scraper 🔍

Extract detailed user profiles from OK.RU (Odnoklassniki), one of the largest social networks in Russia and CIS countries. This actor helps you gather comprehensive user information based on search keywords.

### 🎯 Use Cases

- Lead generation and market research
- Social media analysis
- User behavior research
- Demographic studies
- Influencer discovery
- Academic research

### ✨ Features

- 🔎 Search users by keywords
- 👤 Extract detailed user profiles
- 📸 Get user photos and albums
- 🔗 Collect social connections
- 📊 Gather social metrics
- 🛡️ Built-in stealth protection
- ⚡ High-performance scrolling
- 🎯 Customizable results limit

### 🔢 Output

The actor provides detailed user information including:

- Basic profile information (name, gender)
- Profile URLs and message links
- Profile photos and albums
- User status and relationship info
- Social engagement metrics
- Timestamp of data collection

### 💡 Input Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `keywords` | Array | List of keywords to search for users |
| `maxItems` | Integer | Maximum number of results to collect (default: 50) |

### 📌 Limitations

- Respects OK.RU's terms of service and rate limits
- Results may vary based on search keyword popularity
- Some profile information may be private based on user settings

### 💪 Benefits

- Ready-to-use data in structured JSON format
- Efficient and reliable data collection
- Regular updates and maintenance
- Technical support available

### 🔒 Privacy & Terms

Please ensure compliance with OK.RU's terms of service and privacy policies when using this actor. Use responsibly and respect user privacy.

#### Input Example

A full explanation of an input example in JSON.

```json
{
    "keywords": [
       "sam"
    ],
    "maxItems": 50
}
```

#### Output sample

The results will be wrapped into a dataset which you can always find in the **Storage** tab. Here's an excerpt from the data you'd get if you apply the input parameters above:

And here is the same data but in JSON. You can choose in which format to download your data: JSON, JSONL, Excel spreadsheet, HTML table, CSV, or XML.

```json
[
    {
        "keyword": "sam",
        "userData": {
            "user": {
                "href": "https://ok.ru/profile/588147194786",
                "messageHref": "https://ok.ru/messages/588147194786?cmd=ConversationWrapper&amp;st.convId=PRIVATE_588147194786&amp;st.msgLIR=off&amp;st.cmd=anonymMain",
                "info": {
                    "href": "https://ok.ru/profile/588147194786",
                    "shortLink": "https://ok.ru/profile/588147194786",
                    "shortcutMenuUrl": "https://ok.ru/dk?cmd=ShortcutMenu&amp;origin=GLOBAL_SEARCH_USERS&amp;sc=USER_CARD&amp;t=UserMenu&amp;sl=GLOBAL_SEARCH_USERS&amp;id=588147194786&amp;sp=0&amp;sq=sam&amp;sr=on",
                    "uid": "588147194786",
                    "name": "Sam Sam",
                    "firstName": "Sam",
                    "lastName": "Sam",
                    "gender": "MALE",
                    "photoId": "925305529506",
                    "isVip": false,
                    "isStar": false,
                    "isHobbyExpert": false,
                    "isBirthdayCakeToday": false,
                    "imageUrl": "https://i.okcdn.ru/i?r=BYCRVcDa_InERNEIh199TeQtzuYn0u2Hig2mj0pWitTU9evew_75ObEsPqK9SnaPsn8VXKaJBkCsliNedj9zk_HJVD_MK4uTqzx7DhDNQjBrhYgeZ_lSUZxm0fu6eCuv9LBpBWnlzax_g4gQihdrfJKyV33ejCHDAH3esqlzEmVO9QEMKG_qotTL0X1ijBDUHOeR&dpr=2",
                    "newbie": false
                },
                "location": "",
                "relations": {},
                "friendshipStatus": "NONE",
                "photos": {
                    "photos": [
                        {
                            "photo": {
                                "id": "941637241250",
                                "imgSrc": "https://i.okcdn.ru/i?r=BYCROK8FDwiHmxciuyCkQyrEV3Oyfh4F5aNCiBJS3uzM1V-C1LJ0k-ZFqweJyuoGIl0K0IR_LJgPh-KYY-kmgTgqjCMbMwN2uc8RZG2KV60whsJVoQKd_dfsjbkmz4KahJiAue0HppkzM8Mvj3vWHQIu4hjatAPy0J0PxU3aMgexAteRqboULx9C-tfO6fpYouCI&dpr=2"
                            },
                            "href": "https://ok.ru/profile/588147194786/pphotos/941637241250?cmd=PopLayerPhoto&amp;st.layer.cmd=PopLayerPhoto&amp;st.layer.plc=search&amp;st.layer.photoId=941637241250&amp;st.layer.src.p.userId=588147194786&amp;st.layer.type=FRIEND&amp;st.layer.src.type=USER_ALBUM&amp;st.cmd=anonymMain&st.layer.lg.ftid=0&amp;st.layer.lg.fp=0&amp;st._aid=PS_User_ZoomPersonalPhoto"
                        },
                        {
                            "photo": {
                                "id": "939069672354",
                                "imgSrc": "https://i.okcdn.ru/i?r=BYCB6ChSgrN_ue8jwWXbvkrgFTD5unHB8gGMCllt4iF3w2GVUa13G17SoyRqUIjXT_vtjKfqCx_ChtqKu6se1twzJM4hAz83X9pbpzQ0jlPHfr68fAMBbM71GMRFdXvM7vMSa8DLAYc11Ukv4PY_MOYLW2W3fWWKhGYklYARvkfFmpk&dpr=2"
                            },
                            "href": "https://ok.ru/profile/588147194786/pphotos/939069672354?cmd=PopLayerPhoto&amp;st.layer.cmd=PopLayerPhoto&amp;st.layer.plc=search&amp;st.layer.photoId=939069672354&amp;st.layer.src.p.userId=588147194786&amp;st.layer.type=FRIEND&amp;st.layer.src.type=USER_ALBUM&amp;st.cmd=anonymMain&st.layer.lg.ftid=0&amp;st.layer.lg.fp=0&amp;st._aid=PS_User_ZoomPersonalPhoto"
                        },
                        {
                            "photo": {
                                "id": "939069672098",
                                "imgSrc": "https://i.okcdn.ru/i?r=BYCB6ChSgrN_ue8jwWXbvkrgFSi2Eyauu4AzVnrn_jAHGS2Vw03J553DsgRRIZLZPbX1jKfqCx_ChtqKu6se1twzJM4hAz83X9pbpzQ0jlPHfr68fAMBbM71GMRFdXvM7vMSa8DLAYc11Ukv4PY_MOYLW2W3fWWKhGYklYARvkfFmpk&dpr=2"
                            },
                            "href": "https://ok.ru/profile/588147194786/pphotos/939069672098?cmd=PopLayerPhoto&amp;st.layer.cmd=PopLayerPhoto&amp;st.layer.plc=search&amp;st.layer.photoId=939069672098&amp;st.layer.src.p.userId=588147194786&amp;st.layer.type=FRIEND&amp;st.layer.src.type=USER_ALBUM&amp;st.cmd=anonymMain&st.layer.lg.ftid=0&amp;st.layer.lg.fp=0&amp;st._aid=PS_User_ZoomPersonalPhoto"
                        },
                        {
                            "photo": {
                                "id": "939069662114",
                                "imgSrc": "https://i.okcdn.ru/i?r=BYCB6ChSgrN_ue8jwWXbvkrgFTD5unHB8gGMCllt4iF3w2GVUa13G17SoyRqUIjXT_vtjKfqCx_ChtqKu6se1twzJM4hAz83X9pbpzQ0jlPHfr68fAMBbM71GMRFdXvM7vMSa8DLAYc11Ukv4PY_MOYLW2W3fWWKhGYklYARvkfFmpk&dpr=2"
                            },
                            "href": "https://ok.ru/profile/588147194786/pphotos/939069662114?cmd=PopLayerPhoto&amp;st.layer.cmd=PopLayerPhoto&amp;st.layer.plc=search&amp;st.layer.photoId=939069662114&amp;st.layer.src.p.userId=588147194786&amp;st.layer.type=FRIEND&amp;st.layer.src.type=USER_ALBUM&amp;st.cmd=anonymMain&st.layer.lg.ftid=0&amp;st.layer.lg.fp=0&amp;st._aid=PS_User_ZoomPersonalPhoto"
                        }
                    ],
                    "total": 20,
                    "href": "https://ok.ru/profile/588147194786/pphotos?st._aid=PS_User_PersonalPhotos"
                },
                "userStatus": "OFFLINE",
                "isSubscribed": false,
                "isSubscriptionAllowed": false
            },
            "shortcutMenuHref": "https://ok.ru/dk?cmd=ShortcutMenu&amp;origin=GLOBAL_SEARCH_USERS&amp;sc=USER_CARD&amp;t=UserMenu&amp;sl=GLOBAL_SEARCH_USERS&amp;id=588147194786&amp;sp=0&amp;sq=sam&amp;sr=on",
            "scope": "PORTAL",
            "type": "User",
            "stat": {
                "qid": "7e6afcb3f84afc11c83760b1167c0acf",
                "entity": "USER",
                "entityId": "588147194786",
                "location": "GLOBAL_SEARCH_USERS",
                "card": "USER_CARD",
                "query": "sam",
                "position": 0,
                "item": "REGULAR",
                "scope": "PORTAL"
            }
        },
        "scrapedAt": "2025-02-09T07:29:22.136Z"
    },
    ...
]
```

#### Related Actors

- 🔍 [OK.RU Groups Scraper](https://apify.com/easyapi/ok-ru-groups-scraper) - Extract detailed group information from OK.RU social network with comprehensive metrics
- 🎥 [OK.RU Video Scraper](https://apify.com/easyapi/ok-ru-video-scraper) - Scrape video search results from OK.RU including video details and engagement metrics
- 🔍 [VK People Scraper](https://apify.com/easyapi/vk-people-scraper) - Scrape user profiles from VK.com based on keywords with detailed user information
- 👥 [VK Follower Scraper](https://apify.com/easyapi/vk-follower-scraper) - Extract VK group/profile followers data with comprehensive user details
- 🔍 [Gab People Search Scraper](https://apify.com/easyapi/gab-people-search-scraper) - Extract user profiles from Gab.com search results with detailed metrics
- 📱 [Facebook Group Members Scraper](https://apify.com/easyapi/facebook-group-members-scraper) - Extract Facebook group members' data with profile information
- 🔍 [Reddit Communities Search Scraper](https://apify.com/easyapi/reddit-communities-search-scraper) - Extract Reddit communities data with comprehensive metadata
- 📌 [Pinterest Profile Scraper](https://apify.com/easyapi/pinterest-profile-scraper) - Extract Pinterest user profiles data with follower counts and statistics
- 📌 [Pinterest Followers Scraper](https://apify.com/easyapi/pinterest-followers-scraper) - Extract Pinterest followers data with detailed user information
- 👥 [Pinterest Following Scraper](https://apify.com/easyapi/pinterest-following-scraper) - Extract profile information from Pinterest users' following lists
- 🎯 [TikTok Followers Scraper](https://apify.com/easyapi/tiktok-followers-scraper) - Extract detailed follower information from TikTok accounts
- 🎯 [TikTok Following Scraper](https://apify.com/easyapi/tiktok-following-scraper) - Scrape TikTok following lists with detailed user information
- 📱 [Instagram Profile Scraper](https://apify.com/easyapi/instagram-profile-scraper) - Extract detailed Instagram profile data with comprehensive metrics
- 📊 [Facebook Following Scraper](https://apify.com/easyapi/facebook-following-scraper) - Scrape Facebook following list data with profile details
- 🔍 [Medium Following Scraper](https://apify.com/easyapi/medium-following-scraper) - Extract detailed information about Medium users' following lists

# Actor input Schema

## `keywords` (type: `array`):

List of keywords to search for users

## `maxItems` (type: `integer`):

Maximum number of results to collect per keyword

## Actor input object example

```json
{
  "keywords": [
    "sam"
  ],
  "maxItems": 50
}
```

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("easyapi/ok-ru-people-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("easyapi/ok-ru-people-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 '{}' |
apify call easyapi/ok-ru-people-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "OK.RU People Scraper 🔍",
        "description": "Scrape user profiles from OK.RU (Odnoklassniki) social network based on keywords. Extract detailed user information including profile data, photos, and social metrics with high accuracy and stealth capabilities.",
        "version": "0.0",
        "x-build-id": "nKb6bg2JfqB0jKTnn"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/easyapi~ok-ru-people-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-easyapi-ok-ru-people-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/easyapi~ok-ru-people-scraper/runs": {
            "post": {
                "operationId": "runs-sync-easyapi-ok-ru-people-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/easyapi~ok-ru-people-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-easyapi-ok-ru-people-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": [
                    "keywords"
                ],
                "properties": {
                    "keywords": {
                        "title": "Search Keywords",
                        "type": "array",
                        "description": "List of keywords to search for users",
                        "default": [
                            "sam"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxItems": {
                        "title": "Maximum Results",
                        "minimum": 1,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Maximum number of results to collect per keyword",
                        "default": 50
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
