# Reddit Lookup (`clearcheck.io/reddit-lookup`) Actor

Research a Reddit account: profile signals, possible identity indicators, linked usernames and cross-platform matches, with the evidence behind each one.

- **URL**: https://apify.com/clearcheck.io/reddit-lookup.md
- **Developed by:** [Clearcheck Labs](https://apify.com/clearcheck.io) (community)
- **Categories:**
- **Stats:** 2 total users, 1 monthly users, 40.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$200.00 / 1,000 reddit lookups

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Reddit Lookup

**Research a Reddit account in one run.** Give Reddit Lookup a username and it returns a
structured research profile for that account: what the account publicly does, what identity
signals its activity leaves behind, which usernames and accounts appear to be linked to it,
and the evidence behind every one of those signals.

Built by **Clearcheck Labs** for OSINT researchers, investigators, compliance teams and
anyone who needs to understand a Reddit account rather than just read its post history.

***

### What it is for

- **Reddit account research** - turn a bare username into a structured picture of the account
- **OSINT investigations** - collect signals, evidence and cross-platform leads in one step
- **Digital identity research** - see which other handles and profiles line up with the account
- **Due diligence** - review what an account has publicly revealed about itself
- **Profile enrichment** - attach Reddit context to a record you already hold
- **Investigative workflows** - clean JSON output for Make, Zapier, n8n or your own code

### What it is not

Reddit Lookup does **not** identify the real person behind an account, and it does not claim to.
It does not access private Reddit data, deleted content, or anything that is not publicly
observable. It surfaces signals and the evidence for them, with the confidence values the
analysis produced, and leaves the judgement to you.

**Result depth varies by account.** An account that posts often, links to other profiles and is
mentioned elsewhere on the open web produces a rich result. A quiet account with a handful of
comments produces a thin one, with most fields returned as unknown. That is a property of the
account, not a fault in the lookup.

***

### Input

One field, one account per run. No batches, no arrays.

| Field | Required | Description |
|---|---|---|
| **Reddit username** | Yes | The Reddit account to research |

All of these are accepted and normalized for you:

```
hienyimba
u/hienyimba
/user/hienyimba
@hienyimba
https://www.reddit.com/user/hienyimba/
```

A Reddit username is 3-20 characters and may contain letters, digits, underscores and hyphens.
Anything that cannot be a Reddit username is rejected before the lookup runs, so a typo never
costs you a search.

### Output

One dataset item per run:

| Field | What it holds |
|---|---|
| query | The input you gave, the normalized username, and the Reddit profile URL |
| matchFound | Whether a public Reddit profile was found and analyzed |
| collectionSummary | Whether the profile was collected, post and comment counts, external mention count, analysis depth |
| identity | Possible name, location, gender indicators and age range - each with its own confidence and evidence |
| professionalIndicators | Possible roles, self-described roles, workplaces and products |
| publicEmailsFound | Email addresses the account has published itself |
| possibleSocialAccounts | Other platform accounts that appear to belong to the same person |
| linkedUsernames | Other usernames associated with the account |
| crossPlatformMatches | Matched profiles elsewhere, with a match score and the signals behind it |
| communicationProfile | Tone, style, main topics, technical level and observed behaviour |
| evidence | Every supporting item: source type, source URL, excerpt and what it supports |
| limitations | What the analysis could not establish for this account |
| sourceSummary | A plain-language summary of what was collected |
| sectionCounts | Item counts per section, handy for filtering and automation |
| billing | Whether this run was a free-trial search, a paid search, or unmetered |

Confidence values come from the analysis itself and are passed through unchanged. Nothing is
invented, and an empty section means nothing was returned for it - not that the answer is "no".

***

### Pricing

**$0.20 per completed lookup.** One run is one lookup, and you are charged at most once.

You are **not** charged for:

- an invalid or malformed username
- a lookup that could not be completed
- a timeout or a service error
- the Actor's internal polling while it waits for the result

A completed lookup that finds no public profile for the username is still a completed lookup,
and is charged.

#### Free trial

Apify Free-plan users get **3 free completed lookups**. After that the Actor stops before
running any lookup and asks you to upgrade to a paid Apify plan. Paid-plan users do not use the
trial and are charged from the first completed lookup.

***

### Notes on use

Reddit Lookup returns research signals about a publicly visible account. Use it lawfully and
proportionately, and do not treat any single field as a fact about a person. Signals, confidence
values and evidence are provided so you can form your own judgement - not to replace it.

Built and maintained by **Clearcheck Labs**.

# Actor input Schema

## `redditUsername` (type: `string`):

The Reddit account to research. Paste the username, u/username, /user/username, @username or a Reddit profile URL - all are accepted and normalized automatically. A Reddit username is 3-20 characters and may contain letters, digits, underscores and hyphens.

## Actor input object example

```json
{
  "redditUsername": "hienyimba"
}
```

# Actor output Schema

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

No description

# 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 = {
    "redditUsername": "hienyimba"
};

// Run the Actor and wait for it to finish
const run = await client.actor("clearcheck.io/reddit-lookup").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 = { "redditUsername": "hienyimba" }

# Run the Actor and wait for it to finish
run = client.actor("clearcheck.io/reddit-lookup").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "redditUsername": "hienyimba"
}' |
apify call clearcheck.io/reddit-lookup --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,clearcheck.io/reddit-lookup"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/6mn5J4AUYkNkBABUp/builds/XDY29oHPfE4zK5bdf/openapi.json