Skip to main content
POST
https://api.crustdata.com
/
dataset
/
social_post
/
enrich
curl --request POST \
  --url https://api.crustdata.com/dataset/social_post/enrich \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --data '
{
  "professional_network_profile_url": "https://linkedin.com/in/dvdhsu",
  "page": 1
}
'
{
  "posts": [
    {
      "backend_urn": "urn:li:activity:7177658029017776128",
      "actor_backend_urn": "urn:li:member:123456789",
      "share_urn": "urn:li:share:7177658028019900416",
      "share_url": "https://www.linkedin.com/feed/update/urn:li:activity:7177658029017776128",
      "text": "Excited to announce our latest product launch! We've been working on this for months and can't wait for you to try it.",
      "hyperlinks": {
        "company_professional_network_urls": [
          "https://www.linkedin.com/company/retool"
        ],
        "person_professional_network_urls": null,
        "other_urls": [
          "https://retool.com/blog/launch"
        ],
        "media_urls": null
      },
      "actor_name": "David Hsu",
      "date_posted": "2025-03-15 14:30:00",
      "total_reactions": 342,
      "total_comments": 47,
      "reactions_by_type": {
        "LIKE": 210,
        "PRAISE": 85,
        "CURIOUS": 12,
        "EMPATHY": 5,
        "INTEREST": 15,
        "APPRECIATION": 10,
        "ENTERTAINMENT": 5
      },
      "num_shares": 28,
      "reactors": null,
      "comments": null,
      "is_repost_without_thoughts": false,
      "has_video": false
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Pass your API key as Authorization: Bearer <your_api_key>.

Headers

​
x-api-version
enum<string>
required

API version to use for request routing and response shape.

Available options:
2025-11-01

Body

application/json

Provide exactly one identifier — a person profile URL, a social post URL, or a company identifier — along with pagination parameters.

Request payload for /dataset/social_post/enrich. Exactly one identifier must be provided: professional_network_profile_url (fetch person posts), social_post_url (fetch a single post), or a company identifier (company_name, company_domain, crustdata_company_id, company_professional_network_url). Either page or limit must also be provided (not both), unless using social_post_url.

​
professional_network_profile_url
string

Professional network profile URL of a person to fetch posts for (e.g. "https://linkedin.com/in/username").

Example:

"https://linkedin.com/in/dvdhsu"

​
social_post_url
string

Direct URL of a single social post to retrieve.

Example:

"https://www.linkedin.com/feed/update/urn:li:activity:7177658029017776128"

​
company_name
string

Company name to fetch posts for.

Example:

"Retool"

​
company_domain
string

Company website domain to fetch posts for.

Example:

"retool.com"

​
crustdata_company_id
integer<int64>

Crustdata internal company ID to fetch posts for.

Example:

6612

​
company_professional_network_url
string

Company professional network page URL to fetch posts for.

Example:

"https://www.linkedin.com/company/retool"

​
page
integer

Page number for pagination (1–20). Mutually exclusive with limit. Each page returns up to 5 posts.

Required range: 1 <= x <= 20
Example:

1

​
limit
integer

Number of posts to return (1–100). Mutually exclusive with page.

Required range: 1 <= x <= 100
Example:

10

​
fields
string

Comma-separated list of response fields to include. Use to reduce payload size.

Example:

"text,total_reactions,date_posted,share_url"

​
post_types

Filter by post type. Accepts a comma-separated string or an array. Valid values are "original" and "repost".

Example:

"original"

​
max_reactors
integer
default:0

Maximum number of reactor profiles to fetch per post. Requires "reactors" in the fields parameter.

Example:

0

​
max_comments
integer
default:0

Maximum number of comments to fetch per post. Requires "comments" in the fields parameter.

Example:

0

Response

Social posts for the requested entity

Response from the social post enrich endpoint containing a list of posts.

​
posts
object[] | null

List of social posts matching the request. Null if no posts found.