CrustData V3: Social Post Search

Search indexed LinkedIn posts by author profile URL, author title or company, keyword, hashtag, date, engagement, reactors, commenters, and mentions: what a.

Tool ID: crustdata_v3_social_post_search

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'crustdata_v3_social_post_search',
  {
    "filters": {
      "field": "email",
      "type": "=",
      "value": {}
    },
    "cursor": "cursor_123",
    "limit": 20
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute crustdata_v3_social_post_search --input '{
  "filters": {
    "field": "email",
    "type": "=",
    "value": {}
  },
  "cursor": "cursor_123",
  "limit": 20
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "posts": [
      {
        "share_urn": "example"
      }
    ],
    "next_cursor": "cursor_123",
    "total_count": 123
  }
}

Use deepline describe crustdata_v3_social_post_search --json for the latest machine-readable contract.

Input reference

Request body for the indexed social post search. Every key is optional. {} matches the whole dataset.

Name	Type	Required	Default	Details
`payload.filters`	`object`	No	—	A single `SocialPostDbSearchCondition` or a nested `SocialPostDbSearchConditionGroup`. Omit to match every indexed post.
`payload.cursor`	`string`	No	—	Opaque cursor from a prior response’s `next_cursor`. Send the same `filters`, `sorts`, and `fields` with it. A cursor issued for a different body is rejected with `Invalid cursor`.
`payload.limit`	`integer`	No	`20`	Posts per page. `0` returns `total_count` alone and costs nothing. Minimum: 0. Maximum: 1000.
`payload.sorts`	`array`	No	—	Ordering rules applied in array order. Defaults to `date_posted` descending.
`payload.fields`	`array`	No	—	Dot-paths to include in each returned post, for example `actor.name` or a whole group such as `engagement`. Omit to return everything. `actor.location` and `reposter.location` are selected whole. their sub-keys are filterable but not selectable. `reactors` and `comments` are returned in full and can be long, so leave them out unless you need them. Filter-only fields (`content_type`, `materialized_at`) are rejected here.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.posts`	`array`	Yes	—	Matching posts for the current page. Empty when `limit` is 0 or nothing matches.
`result.data.posts[].share_urn`	`string`	Yes	—	Post URN, the stable post id.
`result.data.posts[].backend_urn`	`string \| null`	No	—	—
`result.data.posts[].entity_urn`	`string \| null`	No	—	—
`result.data.posts[].parent_post_urn`	`string \| null`	No	—	URN of the original post on reposts. Empty string on original posts.
`result.data.posts[].share_url`	`string \| null`	No	—	Public URL of the post.
`result.data.posts[].text`	`string \| null`	No	—	—
`result.data.posts[].post_type`	`"original" \| "repost_without_thoughts" \| "repost_quote"`	No	—	Allowed: `original`, `repost_without_thoughts`, `repost_quote`.
`result.data.posts[].is_edited`	`boolean \| null`	No	—	—
`result.data.posts[].has_video`	`boolean \| null`	No	—	—
`result.data.posts[].date_posted`	`string \| null`	No	—	ISO-8601 UTC timestamp.
`result.data.posts[].hashtags`	`array \| null`	No	—	—
`result.data.posts[].content_types`	`array`	No	—	Attachment classes present on the post (video, image, document, article, poll).
`result.data.posts[].actor`	`object`	No	—	The post author (`actor`) or the resharing account (`reposter`). Keys the source record lacks are omitted rather than returned as null.
`result.data.posts[].actor.actor_type`	`"person" \| "company"`	No	—	Allowed: `person`, `company`.
`result.data.posts[].actor.crustdata_entity_id`	`integer`	No	—	Crustdata person id or company id, per `actor_type`.
`result.data.posts[].actor.linkedin_id`	`string`	No	—	Numeric professional network id, when known.
`result.data.posts[].actor.professional_network_urn`	`string`	No	—	Profile URN in URL form.
`result.data.posts[].actor.professional_network_url`	`string`	No	—	Public profile URL.
`result.data.posts[].actor.name`	`string`	No	—	—
`result.data.posts[].actor.headline`	`string`	No	—	—
`result.data.posts[].actor.title`	`string`	No	—	Current job title. People only.
`result.data.posts[].actor.company_name`	`string`	No	—	Current employer name. People only.
`result.data.posts[].actor.industry`	`string`	No	—	—
`result.data.posts[].actor.location`	`object`	No	—	—
`result.data.posts[].actor.location.raw`	`string`	No	—	—
`result.data.posts[].actor.location.city`	`string`	No	—	—
`result.data.posts[].actor.location.state`	`string`	No	—	—
`result.data.posts[].actor.location.country`	`string`	No	—	—
`result.data.posts[].actor.location.continent`	`string`	No	—	—
`result.data.posts[].actor.profile_picture_url`	`string`	No	—	—
`result.data.posts[].reposter`	`object`	No	—	The post author (`actor`) or the resharing account (`reposter`). Keys the source record lacks are omitted rather than returned as null.
`result.data.posts[].reposter.actor_type`	`"person" \| "company"`	No	—	Allowed: `person`, `company`.
`result.data.posts[].reposter.crustdata_entity_id`	`integer`	No	—	Crustdata person id or company id, per `actor_type`.
`result.data.posts[].reposter.linkedin_id`	`string`	No	—	Numeric professional network id, when known.
`result.data.posts[].reposter.professional_network_urn`	`string`	No	—	Profile URN in URL form.
`result.data.posts[].reposter.professional_network_url`	`string`	No	—	Public profile URL.
`result.data.posts[].reposter.name`	`string`	No	—	—
`result.data.posts[].reposter.headline`	`string`	No	—	—
`result.data.posts[].reposter.title`	`string`	No	—	Current job title. People only.
`result.data.posts[].reposter.company_name`	`string`	No	—	Current employer name. People only.
`result.data.posts[].reposter.industry`	`string`	No	—	—
`result.data.posts[].reposter.location`	`object`	No	—	—
`result.data.posts[].reposter.location.raw`	`string`	No	—	—
`result.data.posts[].reposter.location.city`	`string`	No	—	—
`result.data.posts[].reposter.location.state`	`string`	No	—	—
`result.data.posts[].reposter.location.country`	`string`	No	—	—
`result.data.posts[].reposter.location.continent`	`string`	No	—	—
`result.data.posts[].reposter.profile_picture_url`	`string`	No	—	—

The table shows the first 50 fields. Expand the raw schema below for every field.

This output schema is too large for an inline display. Read the complete live contract with deepline describe crustdata_v3_social_post_search --json.

Deepline cost

Pricing model: per_result (per result).
Estimated Deepline credits: 0.2 per pricing unit.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation