Collecting profiles
Use these endpoints to collect profiles and engagement data from LinkedIn posts, enrich the collected profiles, and save the results in lists in Woodpecker.
Collect profiles from LinkedIn posts
Collect profiles of people who reacted to or commented on selected LinkedIn posts. Woodpecker saves the profiles, reaction types, and comments to a new list.
You do not need a connected LinkedIn account to use this workflow.
How the workflow works
- Start collection. Submit LinkedIn post URLs and choose whether to collect comments, reactions, or both.
- Check progress. Use the returned collector IDs to check the status of the request. Processing is asynchronous and typically takes 5–10 minutes.
- Use the results. Woodpecker saves the collected profiles and engagement data to a new list. Open the list in Woodpecker to work with the results, add the profiles to campaigns, or continue by enriching them.
- Enrich the profiles. Start enrichment for the list to add available contact and company data to the collected profiles.
- Check enrichment progress. Use the returned action ID to monitor the enrichment. The enriched data is saved to the same list.
After collecting comments and reactions, the list will contain LinkedIn Profile URL, LinkedIn Post, Reaction, and Comment text columns. Enrichment adds available contact and company data to the same list. Lists are available in the Woodpecker app but are not exposed as a separate public API resource yet. Learn how lists work in Woodpecker.
Collection can use account credits. Collecting profiles from reactions costs 1 credit per 100 profiles (0.01 credit per profile), while collecting profiles from comments costs 3 credits per 100 profiles (0.03 credit per profile). Credits are used only for profiles that are successfully collected. The GET endpoints used to check collection status do not use credits.
Enrichment costs 1.5 credits per successfully enriched profile.
Available endpoints
| Endpoint | Method and path | Use it to |
|---|---|---|
| Collect profiles from posts | POST /rest/v2/linkedin/post_profiles_collectors/enqueue | Create a list and start one or more collection jobs |
| List collection jobs | GET /rest/v2/linkedin/post_profiles_collectors | List recent collection jobs and check their statuses |
| Get a collection job | GET /rest/v2/linkedin/post_profiles_collectors/{uid} | Get the details and status of a collection job |
| Enrich collected profiles | POST /rest/v2/linkedin/post_profiles_collectors/enrichment_actions/enqueue | Enrich the profiles in a collected list |
| Get enrichment status | GET /rest/v2/linkedin/post_profiles_collectors/enrichment_actions/{action_uid} | Check the status of an enrichment action |