Skip to main content
POST
/
webhooks
/
profiles
curl -X POST https://api.dataforb2b.ai/webhooks/profiles \
  -H "api_key: YOUR_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_ids": [
      "https://www.example.com/in/john-doe/",
      "https://www.example.com/in/jane-smith/",
      "prof_PVXj1LZJg54zXKcnKNBusu8LgvJX5SYm5QYj"
    ]
  }'

{
  "added": 2,
  "already_monitored": 0,
  "failed": 0,
  "errors": []
}

Documentation Index

Fetch the complete documentation index at: https://docs.dataforb2b.ai/llms.txt

Use this file to discover all available pages before exploring further.

Add one or more profiles to your monitoring list. Each profile is enriched, saved to the database, and added to the watch list. You will receive webhook events when any monitored profile changes. Profiles already monitored by your subscription are skipped (no re-scrape, no extra cost).

​
Credit Cost

ActionCredits
Profile monitoring0.5 credits per profile per day

​
Request Body

​
profile_ids
array
required
List of profile identifiers to monitor (maximum 50 per request). Supports multiple formats:
  • Full URL: https://www.example.com/in/john-doe
  • Short URL: example.com/in/john-doe
  • Public ID: john-doe
  • Encoded ID: prof_PVXj1LZJg54zXKcnKNBusu8LgvJX5SYm5QYj

​
Response

​
added
number
Number of profiles successfully added to monitoring
​
already_monitored
number
Number of profiles skipped because they are already monitored by your subscription
​
failed
number
Number of profiles that failed to be added
​
errors
array
List of error details for failed profiles
curl -X POST https://api.dataforb2b.ai/webhooks/profiles \
  -H "api_key: YOUR_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_ids": [
      "https://www.example.com/in/john-doe/",
      "https://www.example.com/in/jane-smith/",
      "prof_PVXj1LZJg54zXKcnKNBusu8LgvJX5SYm5QYj"
    ]
  }'

{
  "added": 2,
  "already_monitored": 0,
  "failed": 0,
  "errors": []
}