Social

Enrich a social profile

POST /v1/socials

Requires people:enrich. Supported platforms are linkedin, x, instagram, tiktok, youtube, github, reddit, and facebook.

curl https://api.ploid.com/v1/socials \
  -H "Authorization: Bearer $PLOID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "github",
    "identifier": "octocat"
  }'

Pass a handle, vanity slug, or full profile URL in identifier. When you pass a URL, its domain must match platform.

{
    "data": {
        "platform": "github",
        "profile": {}
    },
    "meta": {
        "credits_charged": 1,
        "remaining_credits": 99
    }
}

Public LinkedIn reads

LinkedIn reads require linkedin:read and do not require caller-provided cookies, proxies, or provider keys.

GET /v1/linkedin/profile?url=https://www.linkedin.com/in/example
POST /v1/linkedin/search
GET /v1/linkedin/posts?identifier=example&limit=10

The same family includes profile comments, company details, and company posts. Jobs, groups, ads, services, geographic lookup, reactions, and lead-search endpoints are not part of the public API. The current paths and query parameters are enumerated in the OpenAPI document.

Errors and limits

/v1/socials and /v1/linkedin/* are each capped at 60 requests per minute and 600 per hour, in addition to the organization and API-key buckets. Successful social enrichment consumes the documented credit cost for its platform; not-found and provider-failure responses are not charged. See Errors & rate limits.

Connected-account actions

Public reads and connected-account actions are separate. Mutating actions require a verified connection and exact human approval where applicable; the API does not accept raw session cookies or arbitrary provider credentials.