# ✅ Instagram User Details (`datamagnet/instagram-user-details`) Actor

Get public Instagram profile details from usernames, user IDs, or profile URLs. Extract contact info like email or phone when available, plus optional country, date joined, and embed-safe media URLs for faster lead generation and profile research.

- **URL**: https://apify.com/datamagnet/instagram-user-details.md
- **Developed by:** [Datamagnet](https://apify.com/datamagnet) (community)
- **Categories:** Social media, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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/docs.md):

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

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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

## Instagram Profile Contact Scraper

Instagram Profile Contact Scraper helps you quickly collect public Instagram profile details from a username, user ID, or profile URL. It is built for marketers, recruiters, sales teams, and researchers who need Instagram contact information and profile data in one place. Use it to find public email addresses, phone numbers, profile details, and optional account background such as country and date joined. If you need a simple way to gather Instagram profile data for outreach, research, or lead generation, this actor saves time and removes manual work.

### Key Features

- Extract public Instagram profile details from usernames, user IDs, or profile URLs.
- Collect contact information such as email addresses and phone numbers when available.
- Include extra account background like country and date joined when you need deeper profile context.
- Generate embed-safe media URLs for use on websites and other online destinations.
- Process one or many Instagram accounts in a single run for faster research.
- Return profile data exactly as provided so you can review it without guesswork.
- Support lead generation, influencer research, brand checks, and audience analysis workflows.

### Use Cases

#### Lead Generation
Sales teams and business development professionals use this actor to find public contact details on Instagram profiles. The returned email, phone, and profile information help teams decide whether an account is worth outreach and how to personalize the first message.

#### Influencer Discovery
Agencies and brands can review profile details before contacting creators for partnerships. Fields like verification status, profile links, and contact details make it easier to shortlist creators who are reachable and relevant.

#### Market Research
Researchers and analysts use the actor to study public Instagram accounts at scale. Profile details, country, and date joined can help identify audience patterns, account maturity, and regional presence.

#### Brand Verification
Marketing teams can check whether a public Instagram account looks legitimate before engaging with it. Details such as verified status, profile links, and contact information help teams reduce risk and avoid wasting time on low-quality accounts.

#### Outreach List Building
Recruiters, agencies, and growth teams can build cleaner outreach lists from public Instagram profiles. By collecting usernames, contact details, and profile information in one place, they can move faster from discovery to contact.

#### Content and Partnership Research
Partnership managers and content teams can review public profile data before proposing collaborations. Knowing the account’s contact details, profile type, and optional background information helps them choose the right partner and prepare a better pitch.

### Input

| Field | Type | Required | Description | Example |
|---|---|---:|---|---|
| Usernames / IDs / URLs | string | Yes | Enter one or more Instagram usernames, user IDs, or profile URLs you want to look up. | mrbeast |
| Include about info | boolean | No | Turn this on if you also want country and date joined. | false |
| Embed-safe URLs | boolean | No | Turn this on if you need media links that can be used on a website. | false |

### Output

| Field | Type | Description |
|---|---|---|
| creation_source | string | Shows where the profile data came from or how it was created. Useful for understanding the source of the record. |
| icon_url | string | A small image link connected to the profile or content, if available. |
| image_url | string | A larger image link connected to the profile or content, if available. |
| is_pinned | boolean | Tells you whether the item is highlighted or pinned. |
| is_verified | boolean | Shows whether the account is verified. Helpful for checking trust and authenticity. |
| link_id | number | A unique number for the linked item. Useful for identifying the record internally. |
| link_type | string | Describes the kind of link included in the record. |
| lynx_url | string | A redirect-style link associated with the profile or content. |
| media_accent_color_hex | string | A color value associated with the media or profile card, if available. |
| media_type | string | Describes the type of media attached to the record. |
| open_external_url_with_in_app_browser | boolean | Indicates whether the link is intended to open in a built-in browser view. |
| title | string | The title or label shown for the item, if any. |
| url | string | The main public link connected to the record. |

### Sample Output

```json
[
  {
    "creation_source": "NONE",
    "icon_url": "",
    "image_url": "",
    "is_pinned": false,
    "is_verified": false,
    "link_id": 18074999609552950,
    "link_type": "external",
    "lynx_url": "https://l.instagram.com/?u=https%3A%2F%2Fyoutu.be%2FiYlODtkyw_I%3Fis%3DiH-70MliT9c7Tcuu%26fbclid%3DPAZXh0bgNhZW0CMTEAc3J0YwZhcHBfaWQPNTY3MDY3MzQzMzUyNDI3AAGnlYacVU9x5C63Qb-sdCc99IEKTGFf8zccJPS6DAAvv4dFMiGAqo_IIR39UhM_aem__nyLhLSpWrRkARzYVrysGQ&e=AUCe1XBuOpaOXqtIz9XYFqIemYEOke6ChWU5q6fUSmDqVZWvK--chm...",
    "media_accent_color_hex": "",
    "media_type": "none",
    "open_external_url_with_in_app_browser": true,
    "title": "",
    "url": "https://youtu.be/iYlODtkyw_I?is=iH-70MliT9c7Tcuu"
  }
]
````

### How It Works

1. You enter one or more Instagram usernames, user IDs, or profile URLs.
2. You choose whether you want extra background details like country and date joined.
3. You decide whether you need embed-safe media links.
4. The actor looks up each public profile automatically and gathers the available details.
5. Your results are returned in a clean format that is easy to review, filter, and export.

### Getting Started

Getting started is simple and does not require coding knowledge. Click **Try for free**, paste in the Instagram username, user ID, or profile URL you want to check, and choose whether you want extra about information or embed-safe links. Then click **Run** and let the actor do the work for you. When it finishes, you can download the results as JSON, CSV, or Excel depending on how you want to use the data.

### Frequently Asked Questions

#### Do I need technical skills?

No. This actor is designed for business users, marketers, recruiters, and researchers who want Instagram profile details without manual copying and pasting. You only need to enter the account name, ID, or profile link and choose any optional settings.

#### How fast does it run?

Speed depends on how many profiles you look up and how much information is available for each one. Single-profile lookups are usually quick, while larger lists naturally take longer. The actor is built to automate the process so you can save time compared with checking profiles one by one.

#### What format is the output?

Your results are available in formats that are easy to work with, including JSON, CSV, and Excel. That makes it simple to share the data with teammates, import it into spreadsheets, or keep it for later analysis.

#### Is this legal to use?

This actor is intended for public Instagram profile information. You should always use the results responsibly and follow the rules that apply to your use case, including privacy, outreach, and platform policies. If you are collecting contact details, make sure your workflow respects applicable laws and best practices.

#### Can I schedule it to run automatically?

Yes, you can set it up to run on a schedule if you want regular updates. This is useful for ongoing lead lists, influencer monitoring, or tracking changes in public profile details over time. Automated runs help you stay current without repeating the same manual work.

# Actor input Schema

## `include_about` (type: `boolean`):

Turn this on to also include the account's country and date joined.

## `username_or_id_or_url` (type: `array`):

Enter an Instagram username, user ID, or profile URL to look up.

## Actor input object example

```json
{
  "username_or_id_or_url": [
    "mrbeast"
  ]
}
```

# 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 = {
    "include_about": false,
    "username_or_id_or_url": [
        "mrbeast"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("datamagnet/instagram-user-details").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 = {
    "include_about": False,
    "username_or_id_or_url": ["mrbeast"],
}

# Run the Actor and wait for it to finish
run = client.actor("datamagnet/instagram-user-details").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 '{
  "include_about": false,
  "username_or_id_or_url": [
    "mrbeast"
  ]
}' |
apify call datamagnet/instagram-user-details --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "✅ Instagram User Details",
        "description": "Get public Instagram profile details from usernames, user IDs, or profile URLs. Extract contact info like email or phone when available, plus optional country, date joined, and embed-safe media URLs for faster lead generation and profile research.",
        "version": "0.0",
        "x-build-id": "Cin8z8ugXnhh8Qdre"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/datamagnet~instagram-user-details/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-datamagnet-instagram-user-details",
                "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/datamagnet~instagram-user-details/runs": {
            "post": {
                "operationId": "runs-sync-datamagnet-instagram-user-details",
                "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/datamagnet~instagram-user-details/run-sync": {
            "post": {
                "operationId": "run-sync-datamagnet-instagram-user-details",
                "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": [
                    "username_or_id_or_url"
                ],
                "properties": {
                    "include_about": {
                        "title": "Include about info",
                        "type": "boolean",
                        "description": "Turn this on to also include the account's country and date joined."
                    },
                    "username_or_id_or_url": {
                        "title": "Usernames / IDs / URLs",
                        "type": "array",
                        "description": "Enter an Instagram username, user ID, or profile URL to look up.",
                        "items": {
                            "type": "string"
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```