[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Truth Social account posts](https://spiral.ai/integrations/gemini-cli/truth-social-account-posts)

# How to Use Truth Social account posts in Gemini CLI

Fetch posts from an accessible public Truth Social account, with text, timestamps, post IDs, and reply, ReTruth, and like counts. Use it to review public statements across multiple posts and page through more results.

|  |  |
| --- | --- |
| Model | Truth Social account posts |
| Available through | ScrapeCreators |
| Category | Social Media |
| Price | Up to $0.0013 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Truth Social account posts in Gemini CLI

- Use Truth Social account posts for realDonaldTrump and add a tariff statement chronology to this project's report generator. Include each matching post's text, ID, and creation timestamp.
- Use Truth Social account posts for realDonaldTrump to populate a table in this project showing retrieved energy policy posts and their separate reply, ReTruth, and like counts.
- Use Truth Social account posts for realDonaldTrump and add pagination to this project's importer. Deduplicate by post ID and produce a summary of the dates covered by the retrieved records.
- Use Truth Social account posts for realDonaldTrump to create a report in this repository comparing retrieved posts mentioning steel with posts mentioning aluminum. Show the matching text and timestamps.
- Use Truth Social account posts for realDonaldTrump and add a claim review export to this project. Extract checkable claims about manufacturing, with the source post ID and timestamp for each.

## How to set up Truth Social account posts in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Truth Social account posts**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "scrapecreators",
    "model": "scrapecreators/truthsocial-user-posts",
    "input": {
      "trim": false
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds Truth Social account posts on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## Truth Social account posts tools and prices

- [Truth Social · User Posts](https://spiral.ai/tools/scrapecreators/scrapecreators/truthsocial-user-posts) (ScrapeCreators): Up to $0.0013 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| trim |  | — | Set to true for a trimmed down version of the response |
| handle |  | — | Truth Social username |
| user_id |  | — | Truth Social user id. Use this for faster response times. Trumps is 107780257626128497. It is the 'id' field in the profile endpoint. |
| next_max_id |  | — | Used to paginate to next page |

## What can you do with Truth Social account posts in Gemini CLI?

Build a dated policy briefing from public Truth Social statements, with post IDs behind each summary. A coding agent can add pagination and topic filtering to your project, then compare reply, ReTruth, and like counts.

### Public statement chronology

Arrange retrieved statements about tariffs by their creation timestamps to see the sequence of announcements.

### Policy briefing

Summarize an accessible public account's statements about energy policy, citing the post IDs behind each point.

### Engagement comparison

Compare reply, ReTruth, and like counts across retrieved posts about the same policy topic.

### Interview preparation

Find public statements about a specific proposal and turn them into interview questions grounded in the retrieved wording.

### Statement comparison

Compare retrieved statements on a topic across two time periods, identifying changes in wording without assuming a change in policy.

### Claim review queue

Extract checkable claims from public statements and retain their post IDs and timestamps for separate verification.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## Truth Social account posts in other agents

- [Amp](https://spiral.ai/integrations/amp/truth-social-account-posts)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/truth-social-account-posts)
- [Claude](https://spiral.ai/integrations/claude-desktop/truth-social-account-posts)
- [Claude Code](https://spiral.ai/integrations/claude-code/truth-social-account-posts)
- [Cline](https://spiral.ai/integrations/cline/truth-social-account-posts)
- [Codex](https://spiral.ai/integrations/codex/truth-social-account-posts)
- [Cursor](https://spiral.ai/integrations/cursor/truth-social-account-posts)
- [Devin](https://spiral.ai/integrations/devin/truth-social-account-posts)
- [dots](https://spiral.ai/integrations/dots/truth-social-account-posts)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/truth-social-account-posts)
- [Gemini](https://spiral.ai/integrations/gemini/truth-social-account-posts)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/truth-social-account-posts)
- [goose](https://spiral.ai/integrations/goose/truth-social-account-posts)
- [Grok](https://spiral.ai/integrations/grok/truth-social-account-posts)
- [Grok Build](https://spiral.ai/integrations/grok-build/truth-social-account-posts)
- [Hermes](https://spiral.ai/integrations/hermes/truth-social-account-posts)
- [Instinct](https://spiral.ai/integrations/instinct/truth-social-account-posts)
- [Manus](https://spiral.ai/integrations/manus/truth-social-account-posts)
- [Muse](https://spiral.ai/integrations/muse/truth-social-account-posts)
- [Muse Code](https://spiral.ai/integrations/muse-code/truth-social-account-posts)
- [n8n](https://spiral.ai/integrations/n8n/truth-social-account-posts)
- [Notion](https://spiral.ai/integrations/notion/truth-social-account-posts)
- [OpenClaw](https://spiral.ai/integrations/openclaw/truth-social-account-posts)
- [opencode](https://spiral.ai/integrations/opencode/truth-social-account-posts)
- [Perplexity](https://spiral.ai/integrations/perplexity/truth-social-account-posts)
- [Raycast](https://spiral.ai/integrations/raycast/truth-social-account-posts)
- [VS Code](https://spiral.ai/integrations/vscode/truth-social-account-posts)
- [Windsurf](https://spiral.ai/integrations/windsurf/truth-social-account-posts)
- [Zapier](https://spiral.ai/integrations/zapier/truth-social-account-posts)

## More Gemini CLI guides

- [TikTok web device ID](https://spiral.ai/integrations/gemini-cli/tiktok-web-device-id)
- [Truth Social post details](https://spiral.ai/integrations/gemini-cli/truth-social-post-details)
- [TikTok videos using a sound](https://spiral.ai/integrations/gemini-cli/tiktok-videos-using-a-sound)
- [Truth Social profile](https://spiral.ai/integrations/gemini-cli/truth-social-profile)
- [TikTok video transcript](https://spiral.ai/integrations/gemini-cli/tiktok-video-transcript)
- [Twitch Profile](https://spiral.ai/integrations/gemini-cli/twitch-profile)

## Questions about Truth Social account posts in Gemini CLI

**Can Gemini CLI use Truth Social account posts?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Truth Social account posts like any built-in tool.

**How much does Truth Social account posts cost in Gemini CLI?**

Up to $0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

**Do I need a ScrapeCreators account to use Truth Social account posts in Gemini CLI?**

No. Spiral runs Truth Social account posts on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Truth Social account posts in Gemini CLI?**

About two minutes: add the server, then sign in, then check it.

**Does Gemini CLI wait while Truth Social account posts runs?**

Truth Social account posts runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**How fresh are the posts?**

ScrapeCreators says it fetches the latest available information when you make a request. That describes retrieval on request rather than a daily update schedule.

**Do engagement counts include the actual replies?**

The response documents separate totals for replies, ReTruths, and likes. A reply count is a number, not the text of the replies.

**What does ReTruth mean?**

A ReTruth is a reshared Truth. Accounts can reshare their own posts as well as posts from others, so a reshare should not automatically be attributed as newly written text.

**Does public visibility allow unrestricted collection and reuse?**

Truth Social's terms prohibit data mining and similar extraction tools and restrict commercial exploitation of content without express prior written permission. Public visibility does not itself grant those permissions.

