curl --request POST \
  --url https://api.crustdata.com/social_post/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --data '
{
  "filters": {
    "op": "and",
    "conditions": [
      {
        "field": "text",
        "type": "[.]",
        "value": "rust"
      },
      {
        "field": "actor.actor_type",
        "type": "=",
        "value": "person"
      },
      {
        "field": "actor.location.city",
        "type": "=",
        "value": "Kolkata"
      }
    ]
  },
  "sorts": [
    {
      "field": "date_posted",
      "order": "desc"
    }
  ],
  "fields": [
    "share_urn",
    "share_url",
    "text",
    "post_type",
    "actor",
    "date_posted",
    "engagement"
  ],
  "limit": 2
}
'

{
  "posts": [
    {
      "actor": {
        "actor_type": "company",
        "name": "Stripe"
      },
      "date_posted": "2026-08-29T07:17:40Z",
      "engagement": {
        "total_reactions": 139
      },
      "share_url": "https://www.linkedin.com/posts/stripe_give-your-grok-bot-a-card-withlink-bots-activity-7499191937820889089-_uIY"
    },
    {
      "actor": {
        "actor_type": "company",
        "name": "Stripe"
      },
      "date_posted": "2026-08-26T02:01:22Z",
      "engagement": {
        "total_reactions": 253
      },
      "share_url": "https://www.linkedin.com/posts/stripe_john-collison-sits-down-with-canva-cofounder-ugcPost-7497853964009230337-P79J"
    }
  ],
  "next_cursor": "H4sIAOIQqGoC_xXMTQrDIBBA4asE...",
  "total_count": 720
}

Social Post Search

Search the indexed Crustdata social post dataset with structured filter conditions. Each result is a post with its author (person or company page) enriched with a Crustdata id, headline, current title, employer, industry, and structured location, plus engagement counts, every reactor and commenter, resolved mentions, hyperlinks, and document, article, and poll attachments.

Enabled on request. The endpoint is off by default and returns 403 until it is enabled on your account. Contact us to turn it on.

Default rate-limit is 30 requests per minute. Send an email to gtm@crustdata.co to discuss higher limits if needed for your use case.

Billed at 0.5 credits per post returned. limit: 0 returns total_count alone and costs nothing. Supports and/or/all_of filter groups, cursor-based pagination, sorting, field selection, geographic radius filtering on actor.location, and same-element matching on the nested reactors and comments arrays. Only indexed fields are filterable and sortable; see the field descriptions on SocialPostDbSearchCondition and SocialPostDbSearchSort.

The index is rebuilt periodically. For the freshest posts by one person or company, use /social_post/professional_network/enrich/live.

POST

https://api.crustdata.com

social_post

curl --request POST \
  --url https://api.crustdata.com/social_post/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --data '
{
  "filters": {
    "op": "and",
    "conditions": [
      {
        "field": "text",
        "type": "[.]",
        "value": "rust"
      },
      {
        "field": "actor.actor_type",
        "type": "=",
        "value": "person"
      },
      {
        "field": "actor.location.city",
        "type": "=",
        "value": "Kolkata"
      }
    ]
  },
  "sorts": [
    {
      "field": "date_posted",
      "order": "desc"
    }
  ],
  "fields": [
    "share_urn",
    "share_url",
    "text",
    "post_type",
    "actor",
    "date_posted",
    "engagement"
  ],
  "limit": 2
}
'

{
  "posts": [
    {
      "actor": {
        "actor_type": "company",
        "name": "Stripe"
      },
      "date_posted": "2026-08-29T07:17:40Z",
      "engagement": {
        "total_reactions": 139
      },
      "share_url": "https://www.linkedin.com/posts/stripe_give-your-grok-bot-a-card-withlink-bots-activity-7499191937820889089-_uIY"
    },
    {
      "actor": {
        "actor_type": "company",
        "name": "Stripe"
      },
      "date_posted": "2026-08-26T02:01:22Z",
      "engagement": {
        "total_reactions": 253
      },
      "share_url": "https://www.linkedin.com/posts/stripe_john-collison-sits-down-with-canva-cofounder-ugcPost-7497853964009230337-P79J"
    }
  ],
  "next_cursor": "H4sIAOIQqGoC_xXMTQrDIBBA4asE...",
  "total_count": 720
}

Authorizations

Authorization

string

header

required

API key passed as a Bearer token in the Authorization header.

Headers

x-api-version

enum<string>

default:2025-11-01

required

API version to use. This endpoint currently requires 2025-11-01.

Available options:

2025-11-01

Example:

"2025-11-01"

Body

application/json

Search filters, pagination, sorting, and field selection

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

filters

object

A single SocialPostDbSearchCondition or a nested SocialPostDbSearchConditionGroup. Omit to match every indexed post.

Option 1
Option 2

Show child attributes

cursor

string

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.

limit

integer

default:20

Posts per page. 0 returns total_count alone and costs nothing.

Required range: 0 <= x <= 1000

sorts

object[]

Ordering rules applied in array order. Defaults to date_posted descending.

Show child attributes

fields

string[]

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.

Example:

[
  "share_url",
  "date_posted",
  "text",
  "actor.name",
  "actor.company_name",
  "engagement.total_reactions"
]

Response

Posts matching the search criteria with a pagination cursor and total count

posts

object[]

required

Matching posts for the current page. Empty when limit is 0 or nothing matches.

Show child attributes

next_cursor

string | null

required

Opaque cursor for the next page. null on the last page and on limit: 0 queries.

total_count

integer

required

Total number of posts matching the filter across all pages.