Skip to main content

LinkedIn weekly statistics

The report groups LinkedIn outreach statistics by campaign and week, starting from the selected start date. It shows how many prospects are enrolled in each campaign and tracks profile visits, connection requests, direct messages, InMail messages, acceptances, replies, and bounced actions.

Generating a report​

Request the report for a date range and save the returned hash.

Request​

Endpoint​

POST https://api.woodpecker.co/rest/v2/reports/linkedin_weekly_statistics

Headers​

x-api-key: {YOUR_API_KEY}
Content-Type: application/json

See the authentication guide.

Body​

{
"from": "2026-11-09",
"to": "2026-11-15"
}

Use recent dates when running the samples. The start date can be at most 30 days before the day you make the request.

Body schema​
FieldTypeRequiredDescription
fromstringYesStart date in YYYY-MM-DD format
tostringYesEnd date in YYYY-MM-DD format

Request samples​

Generate a report hash​
curl --request POST \
--url "https://api.woodpecker.co/rest/v2/reports/linkedin_weekly_statistics" \
--header "x-api-key: {YOUR_API_KEY}" \
--header "Content-Type: application/json" \
--data '{
"from": "2026-11-09",
"to": "2026-11-15"
}'

Response​

Response examples​

Use the returned hash to retrieve the report.

{
"hash": "b12a4779ced8e31a688baeb3bf7137f8432ee31bff70bb390a37ebf18cb29982"
}
Body schema​
FieldTypeDescription
hashstringIdentifier of the requested report

Retrieving a report​

Send a GET request with the hash returned by the generation request. If status is PENDING, WAITING, or IN_PROGRESS, retry the GET with the same hash. The report is available when status is READY. If status is FAILED, stop polling.

Request​

Endpoint​

GET https://api.woodpecker.co/rest/v2/reports/{hash}

Headers​

x-api-key: {YOUR_API_KEY}

Parameters​

ParameterTypeRequiredDescription
hashstringYesPath parameter returned by the generation request

Rows are ordered by client name, interval start date, and campaign ID.

Request samples​

Retrieve a report using the hash​

Replace the example hash with the value returned by your generation request.

curl --request GET \
--url "https://api.woodpecker.co/rest/v2/reports/{hash}" \
--header "x-api-key: {YOUR_API_KEY}"

Response​

Response examples​

Each action and outcome metric counts distinct prospects for the campaign and week.

{
"status": "READY",
"report": {
"description": "Linkedin_weekly_statistics_2026-11-09-2026-11-15",
"data": [
{
"week_range": "2026-11-09 - 2026-11-15",
"client_name": "Main account",
"client_id": 71258,
"campaign_id": 3826104,
"campaign_name": "Pied Piper partner outreach",
"prospects_in_campaign": 320,
"visit_profile": 147,
"connection_request": 98,
"direct_message": 34,
"inmail_message": 12,
"accepted_connection_request": 31,
"replied_to_connection_request": 5,
"direct_message_replied": 8,
"inmail_message_replied": 3,
"action_bounced": 4
},
{
"week_range": "2026-11-09 - 2026-11-15",
"client_name": "Main account",
"client_id": 71258,
"campaign_id": 3826159,
"campaign_name": "Bachmanity event follow-up",
"prospects_in_campaign": 175,
"visit_profile": 64,
"connection_request": 43,
"direct_message": 19,
"inmail_message": 7,
"accepted_connection_request": 17,
"replied_to_connection_request": 2,
"direct_message_replied": 5,
"inmail_message_replied": 1,
"action_bounced": 2
}
]
}
}

Until the report reaches READY, report is null.

{
"status": "PENDING",
"report": null
}
Body schema​
FieldTypeDescription
statusstringReport generation status. One of PENDING, WAITING, IN_PROGRESS, READY, or FAILED
reportobject or nullReport contents when the status is READY. Otherwise null
  └─ report.descriptionstringReport name, including the date range it covers
  └─ report.dataarrayCampaign statistics by interval, or an empty array when no rows match
    └─ data[].week_rangestringStart and end dates of the interval in YYYY-MM-DD - YYYY-MM-DD format
    └─ data[].client_namestringName of the agency client account or Main account for the requesting account
    └─ data[].client_idintegerID of the account that owns the campaign
    └─ data[].campaign_idintegerCampaign ID
    └─ data[].campaign_namestringCampaign name
    └─ data[].prospects_in_campaignintegerTotal prospects in the campaign, regardless of when they were added
    └─ data[].visit_profileintegerDistinct prospects whose profiles were visited
    └─ data[].connection_requestintegerDistinct prospects who were sent a connection request
    └─ data[].direct_messageintegerDistinct prospects who were sent a direct message
    └─ data[].inmail_messageintegerDistinct prospects who were sent an InMail message
    └─ data[].accepted_connection_requestintegerDistinct prospects who accepted a connection request
    └─ data[].replied_to_connection_requestintegerDistinct prospects who replied to a connection request
    └─ data[].direct_message_repliedintegerDistinct prospects who replied to a direct message
    └─ data[].inmail_message_repliedintegerDistinct prospects who replied to an InMail message
    └─ data[].action_bouncedintegerDistinct prospects with a bounced LinkedIn action