# Social Footprint OSINT — Email & Username Account Finder (`ntriqpro/socialscan-osint`) Actor

Resolve the digital footprint of an email or username across GitHub, Instagram, Twitter, Reddit, GitLab and more, enriched with Gravatar and GitHub profiles. 100% passive — public availability lookups only, no logins or notifications to the target. For authorized OSINT and account recovery.

- **URL**: https://apify.com/ntriqpro/socialscan-osint.md
- **Developed by:** [daehwan kim](https://apify.com/ntriqpro) (community)
- **Categories:** Developer tools, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$30.00 / 1,000 footprint resolveds

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

### What does Social Footprint OSINT do?

**Social Footprint OSINT** resolves the **digital footprint of a single email address or username** in one passive lookup. Give it `octocat` or `someone@example.com`, and it reports **which online platforms the identity is registered on** — GitHub, GitLab, Instagram, Pinterest, Reddit, Twitter, Tumblr and Firefox — then **enriches** the result with a **Gravatar** profile (for emails) or the **GitHub public profile** (for usernames), and rolls everything up into a single footprint summary with an **exposure score**.

It is built on the open-source [socialscan](https://github.com/iojw/socialscan) library and runs **100% passively**: it only queries each platform's own public availability endpoint plus public profile APIs. It **never** attempts a login, a password reset, or anything that would notify the person being looked up. Running on the Apify platform adds API access, scheduling, integrations and monitoring on top.

### Why use Social Footprint OSINT?

- **Account recovery** — find where you (or a client) signed up years ago.
- **OSINT & due diligence** — map an identity's public presence from a single seed.
- **Brand & impersonation checks** — see where a username is already taken.
- **Security research** — assess a target's digital exposure during an authorized engagement.

Unlike single-source checkers, this Actor **layers multiple passive sources** into one enriched result, so the same lookup returns far more context.

### How to use Social Footprint OSINT

1. Open the **Input** tab.
2. Enter a single **email or username** in the `query` field.
3. (Optional) Adjust the **timeout**.
4. Click **Start**. Read the footprint in the **Output** tab.

### Input

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | ✅ | An email address or a username to resolve. |
| `timeout` | integer | | Max seconds for the multi-platform lookup (20–300). |

### Output

```json
{
  "query": "octocat",
  "queryType": "username",
  "accountsFound": 3,
  "platformsRegistered": ["GitHub", "GitLab", "Reddit"],
  "platformDetails": [
    { "platform": "GitLab", "category": "developer", "registered": true, "link": "https://gitlab.com/octocat" }
  ],
  "githubProfile": { "exists": true, "name": "The Octocat", "followers": 12000, "profileUrl": "https://github.com/octocat" },
  "exposureScore": 56,
  "scannedAt": "2026-06-30T00:00:00+00:00"
}
````

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

#### Data table

| Field | Description |
|-------|-------------|
| `query` / `queryType` | The seed and whether it was an email or username |
| `accountsFound` | Number of platforms where the identity is registered |
| `platformsRegistered` | List of platforms where an account exists |
| `platformDetails` | Per-platform result with category and profile link |
| `gravatar` / `githubProfile` | Enrichment from public profile APIs |
| `exposureScore` | 0–100 digital-exposure indicator |

### Pricing

This Actor uses **pay-per-event** pricing: you are charged **once per query** ($0.03) only when at least one public signal (a registered platform, a Gravatar, or a GitHub profile) is resolved. Lookups that return nothing are **not** charged.

### Tips

- Some platforms rate-limit shared cloud IPs; if a run returns few signals, try again shortly.
- Emails get Gravatar enrichment; usernames get GitHub-profile enrichment — pick the seed that matches your goal.

### FAQ, disclaimers, and support

**Is this legal?** The Actor performs only passive, public lookups and never contacts or notifies the target. Use it solely for accounts you own or are authorized to investigate, and comply with all applicable laws and platform terms. It is not affiliated with or endorsed by socialscan or any listed platform.

**Found a bug or want a platform added?** Open an issue on the Issues tab.

# Actor input Schema

## `query` (type: `string`):

A single email address (e.g. someone@example.com) or a username (e.g. octocat) to resolve a social footprint for.

## `timeout` (type: `integer`):

Maximum time for the multi-platform lookup.

## Actor input object example

```json
{
  "query": "octocat",
  "timeout": 90
}
```

# 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 = {
    "query": "octocat",
    "timeout": 90
};

// Run the Actor and wait for it to finish
const run = await client.actor("ntriqpro/socialscan-osint").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 = {
    "query": "octocat",
    "timeout": 90,
}

# Run the Actor and wait for it to finish
run = client.actor("ntriqpro/socialscan-osint").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 '{
  "query": "octocat",
  "timeout": 90
}' |
apify call ntriqpro/socialscan-osint --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Social Footprint OSINT — Email & Username Account Finder",
        "description": "Resolve the digital footprint of an email or username across GitHub, Instagram, Twitter, Reddit, GitLab and more, enriched with Gravatar and GitHub profiles. 100% passive — public availability lookups only, no logins or notifications to the target. For authorized OSINT and account recovery.",
        "version": "1.0",
        "x-build-id": "xh9XIZHgDD37ApIOO"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/ntriqpro~socialscan-osint/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-ntriqpro-socialscan-osint",
                "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/ntriqpro~socialscan-osint/runs": {
            "post": {
                "operationId": "runs-sync-ntriqpro-socialscan-osint",
                "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/ntriqpro~socialscan-osint/run-sync": {
            "post": {
                "operationId": "run-sync-ntriqpro-socialscan-osint",
                "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": [
                    "query"
                ],
                "properties": {
                    "query": {
                        "title": "Email or Username",
                        "type": "string",
                        "description": "A single email address (e.g. someone@example.com) or a username (e.g. octocat) to resolve a social footprint for."
                    },
                    "timeout": {
                        "title": "Timeout (seconds)",
                        "minimum": 20,
                        "maximum": 300,
                        "type": "integer",
                        "description": "Maximum time for the multi-platform lookup."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
