# Prism Truthsocial Pulse API (https://www.socialcrawl.dev/platforms/prism/truthsocial-pulse)

> Fetches a Truth Social profile + recent posts, drills the top posts for full detail (the F13 post-detail path), and runs a content_analysis news echo for the handle, folded into a deterministic activity/sentiment pulse with stable keys + a methodology_version. The profile leg is critical (404 → full refund); posts/drill/news degrade. No Truth Social search exists upstream — this is handle-scoped.

TL;DR: `GET /v1/prism/truthsocial-pulse` costs 20 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `handle` | yes | The Truth Social handle (no @). |
| `drill` | no | How many top posts to drill for full detail (0 to skip). |
| `posts` | no | How many recent posts to pull (window cap). |
| `news_query` | no | Override the content_analysis news keyword (defaults to the handle/display name). |
| `include` | no | CSV subset of posts,news to trim which legs run. |
| `cursor` | no | Opaque pagination cursor for the posts leg. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/prism/truthsocial-pulse?handle=realDonaldTrump" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What is the SocialCrawl Truth Social API (Prism Truth Social Pulse)?

GET /v1/prism/truthsocial-pulse takes one Truth Social handle and folds four legs into a single response: the profile, recent posts, a per-post detail drill, and a news echo of what the press says around those posts. One call replaces the profile, timeline, per-post, and news requests you would otherwise chain.

### What does the drill parameter do?

drill controls the per-post detail leg: it expands recent posts into fuller detail (engagement and context) instead of a summary timeline. Pass posts to set how many recent posts to pull and cursor to page through them.

### What is the news echo?

The news_query leg searches news and web coverage related to the handle or a topic you pass, so you see the posts alongside how the press is reacting. Leave it off with include if you only want the on-platform data.

### How much does a truthsocial-pulse call cost?

Each call is a flat 20 credits covering the profile, posts, drill, and news legs. New accounts get 100 free credits with no credit card. If a strict majority of the legs fail, part of the cost is refunded automatically, and if all legs fail the full 20 credits come back.

### Why use truthsocial-pulse instead of separate calls?

One call replaces the profile lookup, timeline pull, per-post detail, and news search you would otherwise orchestrate and merge. It returns one handle-level pulse over Truth Social plus the press reaction, so you monitor a figure without stitching endpoints together.

See the full Prism API: https://www.socialcrawl.dev/platforms/prism

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I get a Truth Social handle's profile and recent posts in one API call?
- What API returns Truth Social posts plus the news echo around them?
- Truth Social monitoring API with per-post detail