Profile Data Request Parameters

Endpoint

https://gw.magicalapi.com/profile-data

The Profile Data service accepts the following parameters in the request body:

Parameter	Type	Required	Description	Example
profile_name	string	Yes	LinkedIn profile username (found in profile URL after /in/)	"williamhgates"
webhook_url	string	No	Your webhook endpoint URL to receive results automatically. Must be from a whitelisted domain. See Webhook Guide	"https://yourdomain.com/webhook"

Sample Request Body

Using Request ID (Polling)

{
    "profile_name": "williamhgates"
}

Using Webhook

{
    "profile_name": "williamhgates",
    "webhook_url": "https://yourdomain.com/api/webhook"
}

tip

Make sure to:

• Use the exact profile username from the LinkedIn URL
• Do not include the full LinkedIn URL, just the username
• The username is typically found after /in/ in the profile URL
• For webhooks, ensure your domain is whitelisted in the MagicalAPI Dashboard

Example Workflows

Using Request ID (Polling)

1. Send Initial Request

curl -X POST "https://gw.magicalapi.com/profile-data" \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR-API-KEY" \
  -d '{"profile_name": "williamhgates"}'

2. Check Status (using the same endpoint)

curl -X POST "https://gw.magicalapi.com/profile-data" \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR-API-KEY" \
  -d '{"request_id": "abc123xyz"}'

Using Webhook

Send a single request and receive results automatically:

curl -X POST "https://gw.magicalapi.com/profile-data" \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR-API-KEY" \
  -d '{
    "profile_name": "williamhgates",
    "webhook_url": "https://yourdomain.com/api/webhook"
  }'

Results will be automatically delivered to your webhook endpoint when processing is complete. Learn more about setting up webhooks.