# Cross Profile Resolver (`novashieldai/cross-profile-resolver`) Actor

Check if a username exists across 80+ social media and web platforms. Like Sherlock/Maigret but as an API.

- **URL**: https://apify.com/novashieldai/cross-profile-resolver.md
- **Developed by:** [Ali haydar Karadaş](https://apify.com/novashieldai) (community)
- **Categories:** Lead generation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

## 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

## Cross Profile Resolver

Cross Profile Resolver checks whether a username exists across 80+ social media and web platforms in a single run. If you need to find all the places a username is registered -- for brand audits, OSINT, or competitive research -- this is the most comprehensive username checker on Apify.

### What does Cross Profile Resolver do?

Give it a username and it will probe over 80 platforms -- from Twitter and Instagram to GitHub, Steam, Reddit, Spotify, and dozens more. For each platform, you get a clear found/not-found result, the profile URL, the HTTP status code, response time, and the platform category.

Three modes are available. **Resolve** checks a single username across all (or filtered) platforms. **Bulk Resolve** does the same for a list of usernames. **Platforms** returns the full list of supported platforms so you can see exactly what's covered before running a scan.

You can also filter by category (social, dev, gaming, music, business, media, other) or limit the check to specific platforms. This keeps your runs fast and focused when you only care about certain networks.

### What data do you get?

- **platform_name** -- display name of the platform (e.g., Twitter, GitHub)
- **url** -- the profile URL that was checked
- **found** -- whether the profile exists on that platform
- **status_code** -- HTTP status code received
- **response_time_ms** -- how fast the platform responded
- **category** -- platform category (social, dev, gaming, etc.)
- **error** -- error message if the check failed

For each username, you also get summary counts: **total_checked**, **found_count**, **not_found_count**, and **error_count**.

### Who is this for?

- **OSINT investigators** -- map a person's digital footprint across the web
- **Brand managers** -- find out where your brand name is already taken or being squatted
- **Recruiters and HR teams** -- verify candidate social presence across platforms
- **Security researchers** -- identify accounts tied to a handle for threat analysis
- **Journalists** -- track down sources across multiple networks quickly

### How to use it

1. Open the actor in Apify Console and pick your mode (resolve, bulk_resolve, or platforms).
2. Enter a username or a list of usernames.
3. Optionally filter by categories or specific platforms.
4. Click "Start" and wait for results.
5. Export as JSON, CSV, or Excel, or pull results via the Apify API.

### Input parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| mode | string | resolve | resolve = single username, bulk_resolve = multiple usernames, platforms = list supported platforms |
| username | string | -- | Username to check (for resolve mode). 1-39 chars, alphanumeric with dots, underscores, hyphens. |
| usernames | array | -- | List of usernames to check (for bulk_resolve mode) |
| categories | array | -- | Filter platforms by category: social, dev, gaming, music, business, media, other |
| platforms | array | -- | Filter to specific platform keys (e.g., github, twitter, instagram) |
| category | string | -- | Filter platform list by a single category (for platforms mode only) |

### Sample output

```json
{
  "username": "johndoe",
  "total_checked": 84,
  "found_count": 12,
  "not_found_count": 69,
  "error_count": 3,
  "results": [
    {
      "platform_name": "GitHub",
      "url": "https://github.com/johndoe",
      "found": true,
      "status_code": 200,
      "response_time_ms": 187.4,
      "category": "dev",
      "error": null
    },
    {
      "platform_name": "Twitter",
      "url": "https://twitter.com/johndoe",
      "found": true,
      "status_code": 200,
      "response_time_ms": 312.1,
      "category": "social",
      "error": null
    },
    {
      "platform_name": "Steam",
      "url": "https://steamcommunity.com/id/johndoe",
      "found": false,
      "status_code": 404,
      "response_time_ms": 95.2,
      "category": "gaming",
      "error": null
    }
  ]
}
````

### How much does it cost?

Each result costs **$0.012**. Resolving one username across all 80+ platforms counts as one result.

Apify gives every new user $5 in free monthly credits, so you can run roughly 400 full resolutions for free.

### Common questions

**How many platforms does it support?**
Over 80, spanning social media, developer tools, gaming, music streaming, business networks, and more. Use the "platforms" mode to get the full current list.

**Can I check just a few specific platforms instead of all of them?**
Yes. Use the `platforms` or `categories` filter to narrow the scope. This also makes runs faster and cheaper.

**What if a platform blocks the request?**
The result for that platform will show an error message and won't count as "found." The rest of the platforms still get checked normally.

### Contact & Custom Solutions

Need a custom scraper, higher volume, or a specific integration? We're here to help.

If anything isn't working right or you need support, don't hesitate to reach out.

- Telegram: [t.me/novashield\_dev](https://t.me/novashield_dev)
- Email: novashield.dev@gmail.com

# Actor input Schema

## `mode` (type: `string`):

Operation mode: resolve (single username), bulk\_resolve (multiple usernames), or platforms (list supported platforms).

## `username` (type: `string`):

Username to check (for 'resolve' mode). 1-39 chars, alphanumeric with dots, underscores, hyphens.

## `usernames` (type: `array`):

List of usernames to check (for 'bulk\_resolve' mode).

## `categories` (type: `array`):

Filter platforms by category. Leave empty for all. Options: social, dev, gaming, music, business, media, other.

## `platforms` (type: `array`):

Filter to specific platform keys (e.g., \['github', 'twitter', 'instagram']). Leave empty for all.

## `category` (type: `string`):

Filter platform list by a single category (for 'platforms' mode only).

## Actor input object example

```json
{
  "mode": "resolve"
}
```

# 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("novashieldai/cross-profile-resolver").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("novashieldai/cross-profile-resolver").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 novashieldai/cross-profile-resolver --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Cross Profile Resolver",
        "description": "Check if a username exists across 80+ social media and web platforms. Like Sherlock/Maigret but as an API.",
        "version": "1.0",
        "x-build-id": "ozk8Qm1xe9FWKHGJa"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/novashieldai~cross-profile-resolver/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-novashieldai-cross-profile-resolver",
                "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/novashieldai~cross-profile-resolver/runs": {
            "post": {
                "operationId": "runs-sync-novashieldai-cross-profile-resolver",
                "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/novashieldai~cross-profile-resolver/run-sync": {
            "post": {
                "operationId": "run-sync-novashieldai-cross-profile-resolver",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "resolve",
                            "bulk_resolve",
                            "platforms"
                        ],
                        "type": "string",
                        "description": "Operation mode: resolve (single username), bulk_resolve (multiple usernames), or platforms (list supported platforms).",
                        "default": "resolve"
                    },
                    "username": {
                        "title": "Username",
                        "type": "string",
                        "description": "Username to check (for 'resolve' mode). 1-39 chars, alphanumeric with dots, underscores, hyphens."
                    },
                    "usernames": {
                        "title": "Usernames",
                        "type": "array",
                        "description": "List of usernames to check (for 'bulk_resolve' mode).",
                        "items": {
                            "type": "string"
                        }
                    },
                    "categories": {
                        "title": "Categories",
                        "type": "array",
                        "description": "Filter platforms by category. Leave empty for all. Options: social, dev, gaming, music, business, media, other.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "platforms": {
                        "title": "Platforms",
                        "type": "array",
                        "description": "Filter to specific platform keys (e.g., ['github', 'twitter', 'instagram']). Leave empty for all.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "category": {
                        "title": "Category Filter (platforms mode)",
                        "enum": [
                            "social",
                            "dev",
                            "gaming",
                            "music",
                            "business",
                            "media",
                            "other"
                        ],
                        "type": "string",
                        "description": "Filter platform list by a single category (for 'platforms' mode only)."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
