Skip to main content
GET
/
api
/
network
/
analytics
Load network analytics
curl --request GET \
  --url https://app.puffle.ai/api/network/analytics \
  --header 'Authorization: Bearer <token>'
{ "totalConnections": 842, "topCompanies": [ { "name": "Stripe", "count": 42 }, { "name": "Vercel", "count": 28 } ], "topPositions": [ { "name": "Software Engineer", "count": 120 }, { "name": "Product Manager", "count": 53 } ], "connectionsOverTime": [ { "month": "2024-01", "count": 18 }, { "month": "2024-02", "count": 24 }, { "month": "2024-03", "count": 31 } ] }

​
Overview

Returns four aggregate views over the caller’s network_connections:
  • totalConnections — raw row count
  • topCompanies — top 10 by connection count, descending (null/empty companies excluded)
  • topPositions — top 10 position strings by count, descending (null/empty excluded)
  • connectionsOverTime — monthly growth series keyed by YYYY-MM
Aggregation is in-memory after a full-table fetch. Cheap on small networks, grows linearly with totalConnections.

​
AI agent notes

Use for dashboards, not lookups. This endpoint is optimized for summary views. For per-connection detail call getNetworkConnectionDetail; for raw rows call listNetworkConnections.Empty-state safe. A user who hasn’t imported anything yet gets zeroed arrays, not a 404 — no need to pre-check with listNetworkConnections.No pagination, no filters. The whole network is aggregated every time. If a user reports “my analytics are stale” the answer is always “refetch, no cache to bust”.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Aggregate stats across the caller's network.

Aggregate stats over the caller's LinkedIn network import.

​
totalConnections
integer
required

Total rows in network_connections for the caller.

Required range: 0 <= x <= 9007199254740991
​
topCompanies
object[]
required

Top 10 companies by connection count, descending. Empty and null companies are excluded.

​
topPositions
object[]
required

Top 10 position/title strings by connection count, descending. Empty and null positions are excluded.

​
connectionsOverTime
object[]
required

Connection counts grouped by YYYY-MM, sorted by the underlying connected_on ascending. Connections with no connected_on are omitted.