Linkedin Profile Analysis

GET /analyze-linkedin-url
Description

This endpoint retrieves a lead’s enriched behavioral persona using their LinkedIn profile URL. It verifies the user via an API key, enforces crawl limits, and either fetches cached data or initiates a fresh analysis through Behavely AI. The persona includes social insights, behavioral traits, and communication preferences to help personalize outreach and improve lead engagement.

Query Parameters

Parameter

Type

Required

Description

linkedin_url

string

✅ Yes

The LinkedIn profile URL of the lead you want to analyze.

api_key

string

✅ Yes

The user's unique API key used for authentication and usage tracking.

Authentication

The API key is mandatory and used to authenticate the user via DynamoDB. It must be passed as a query parameter.

Rate Limiting & Usage

Each user has a crawl limit, which varies depending on the plan. The endpoint checks if the user has remaining quota before processing the request. If the limit is reached, the API returns a 403 error.

Hit the API

Endpoint:

curl -X GET "https://api.behavely.ai/analyze-linkedin-url?linkedin_url=https://www.linkedin.com/in/jane-doe-12345&api_key=abc123xyz789"

Response

✅ Success (HTTP 200)

Returns a JSON object containing the enriched persona data for the LinkedIn profile.

{
  "name": "Jane Doe",
  "position": "VP of Marketing",
  "interests": ["Brand Strategy", "Growth Marketing"],
  "communication_style": "Concise and Data-Driven",
  "behavioral_traits": {
    "risk_taking": "Low",
    "openness_to_ideas": "High"
  },
  "social_handles": {
    "twitter": "https://twitter.com/janedoe",
    "github": null
  },
  "dos_and_donts": {
    "do": ["Share industry insights", "Be concise"],
    "dont": ["Use overly technical jargon", "Send cold emails without context"]

❌ Errors

HTTP StatusMessageDescription
- 400Missing Api Token. Please create one...API key not provided or invalid.
- 403Crawl limit reachedUser has exceeded the allowed number of profile crawls.
- 404User not foundNo user found associated with the provided API key.
- 500Failed to fetch persona from external APIExternal enrichment service failed to return valid persona data.

Notes

  • If persona data is already cached in DynamoDB, the API returns it immediately.

  • If not, the system initiates social media discovery and enrichment via Behavely AI’s underlying logic.

  • The crawl count is incremented only after a successful request, ensuring fair usage.