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 |
---|---|---|---|
| string | ✅ Yes | The LinkedIn profile URL of the lead you want to analyze. |
| 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:
Response
✅ Success (HTTP 200)
Returns a JSON object containing the enriched persona data for the LinkedIn profile.
❌ Errors
HTTP StatusMessageDescription
- 400Missing Api Token. Please create one...
API key not provided or invalid.
- 403Crawl limit reached
User has exceeded the allowed number of profile crawls.
- 404User not found
No user found associated with the provided API key.
- 500Failed to fetch persona from external API
External 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.