Skip to content
Xholic AI

Free tools actions

MarkdownAsk ChatGPTAsk Claude

12 actions. Every field marked Required must be sent; account, dryRun, idempotencyKey, confirmCredits and quoteId are the control fields every surface adds.

X profile report

Section titled “X profile report”

free_tools.profile_report · read

A free report on any public X account. report: analytics (followers, posting and engagement over recent posts), audit (profile and content checklist with fixes), best-time (when its posts do best; pass timezone), engagement-rate (average engagement rate with a benchmark), media (its profile picture and header image at full size).

  • MCP tool: x_profile_report. Free tool: loaded on /mcp/free with no account; signed in, reach it with find_actions and run_read_action.
  • REST: GET /v1/free-tools/profile-report
  • CLI: xholic free-tools profile-report
  • Scope: read
  • Plan: Free tool: no account or plan needed
  • Cost: Live X lookup: no credits, counts toward the plan’s X data limits.
  • Rate limit bucket: live_x

Input

Field Type Required Description
handle string ≤ 120 chars Yes X username, with or without @.
report “analytics” \ “audit” \ “best-time” \
timezone string ≤ 80 chars No For analytics and best-time: IANA timezone for times of day.

Example: Audit a profile

Terminal window
curl -G https://api.xholic.ai/v1/free-tools/profile-report \
  -H "Authorization: Bearer $XHOLIC_API_KEY" \
  --data-urlencode "handle=xholicai" \
  --data-urlencode "report=audit"

Shadowban check

Section titled “Shadowban check”

free_tools.shadowban_check · read

Check whether a public X account looks shadowbanned or limited in search, replies and suggestions. A few fresh checks per day; recently checked handles come back from storage.

  • MCP tool: shadowban_check. Free tool: loaded on /mcp/free with no account; signed in, reach it with find_actions and run_read_action.
  • REST: GET /v1/free-tools/shadowban-check
  • CLI: xholic free-tools shadowban-check
  • Scope: read
  • Plan: Free tool: no account or plan needed
  • Cost: Live X lookup: no credits, counts toward the plan’s X data limits.
  • Rate limit bucket: live_x

Input

Field Type Required Description
handle string ≤ 120 chars Yes X username, with or without @.

X trend regions

Section titled “X trend regions”

free_tools.trend_regions · read

The regions X trends are available for, with their region slugs for x_trends.

  • MCP tool: x_trend_regions. Free tool: loaded on /mcp/free with no account; signed in, reach it with find_actions and run_read_action.
  • REST: GET /v1/free-tools/trend-regions
  • CLI: xholic free-tools trend-regions
  • Scope: read
  • Plan: Free tool: no account or plan needed
  • Cost: Free.
  • Rate limit bucket: read

Input

No input.

Section titled “X trends”

free_tools.trends · read

What is trending on X in a region right now (from Xholic’s recent snapshot). Use worldwide or a slug from x_trend_regions such as united-states.

  • MCP tool: x_trends. Free tool: loaded on /mcp/free with no account; signed in, reach it with find_actions and run_read_action.
  • REST: GET /v1/free-tools/trends
  • CLI: xholic free-tools trends
  • Scope: read
  • Plan: Free tool: no account or plan needed
  • Cost: Free.
  • Rate limit bucket: read

Input

Field Type Required Description
region string Yes Region slug such as worldwide or united-states.

Example: Worldwide trends

Terminal window
curl -G https://api.xholic.ai/v1/free-tools/trends \
  -H "Authorization: Bearer $XHOLIC_API_KEY" \
  --data-urlencode "region=worldwide"

Read a thread

Section titled “Read a thread”

free_tools.read_thread · read

Unroll an X thread from the link to any of its posts into one readable piece, with its media.

  • MCP tool: read_thread. Free tool: loaded on /mcp/free with no account; signed in, reach it with find_actions and run_read_action.
  • REST: GET /v1/free-tools/read-thread
  • CLI: xholic free-tools read-thread
  • Scope: read
  • Plan: Free tool: no account or plan needed
  • Cost: Live X lookup: no credits, counts toward the plan’s X data limits.
  • Rate limit bucket: live_x

Input

Field Type Required Description
url string ≤ 500 chars Yes Link to a post in the thread.
Section titled “Link card preview”

free_tools.card_preview · read

Show how a link will look as a card on X (title, description, image, card type) and what is missing from its tags.

  • MCP tool: card_preview. Free tool: loaded on /mcp/free with no account; signed in, reach it with find_actions and run_read_action.
  • REST: GET /v1/free-tools/card-preview
  • CLI: xholic free-tools card-preview
  • Scope: read
  • Plan: Free tool: no account or plan needed
  • Cost: Free.
  • Rate limit bucket: read

Input

Field Type Required Description
url string ≤ 2048 chars Yes The page link to check.

Post media links

Section titled “Post media links”

free_tools.post_media · read

Get download links for the video, GIF or images in a public X post.

  • MCP tool: x_post_media. Free tool: loaded on /mcp/free with no account; signed in, reach it with find_actions and run_read_action.
  • REST: GET /v1/free-tools/post-media
  • CLI: xholic free-tools post-media
  • Scope: read
  • Plan: Free tool: no account or plan needed
  • Cost: Live X lookup: no credits, counts toward the plan’s X data limits.
  • Rate limit bucket: live_x

Input

Field Type Required Description
tweetUrl string ≤ 500 chars Yes Link to the X post.
type “video” \ “gif” \ “image”

Username check

Section titled “Username check”

free_tools.username_check · read

Whether an X username is available, with similar available suggestions when it is taken.

  • MCP tool: x_username_check. Free tool: loaded on /mcp/free with no account; signed in, reach it with find_actions and run_read_action.
  • REST: GET /v1/free-tools/username-check
  • CLI: xholic free-tools username-check
  • Scope: read
  • Plan: Free tool: no account or plan needed
  • Cost: Live X lookup: no credits, counts toward the plan’s X data limits.
  • Rate limit bucket: live_x

Input

Field Type Required Description
handle string ≤ 120 chars Yes X username, with or without @.

X ID converter

Section titled “X ID converter”

free_tools.x_id_convert · read

Convert between an X username and its numeric user id, in either direction.

  • MCP tool: x_id_converter. Free tool: loaded on /mcp/free with no account; signed in, reach it with find_actions and run_read_action.
  • REST: GET /v1/free-tools/x-id-convert
  • CLI: xholic free-tools x-id-convert
  • Scope: read
  • Plan: Free tool: no account or plan needed
  • Cost: Live X lookup: no credits, counts toward the plan’s X data limits.
  • Rate limit bucket: live_x

Input

Field Type Required Description
input string ≤ 120 chars Yes A username, user id or profile link.

Follower count

Section titled “Follower count”

free_tools.follower_count · read

The current follower and following counts of a public X account.

  • MCP tool: x_follower_count. Free tool: loaded on /mcp/free with no account; signed in, reach it with find_actions and run_read_action.
  • REST: GET /v1/free-tools/follower-count
  • CLI: xholic free-tools follower-count
  • Scope: read
  • Plan: Free tool: no account or plan needed
  • Cost: Live X lookup: no credits, counts toward the plan’s X data limits.
  • Rate limit bucket: live_x

Input

Field Type Required Description
handle string ≤ 120 chars Yes X username, with or without @.

Account worth

Section titled “Account worth”

free_tools.account_worth · read

An estimate of what a public X account is worth, from its followers, views and engagement on recent posts.

  • MCP tool: x_account_worth. Free tool: loaded on /mcp/free with no account; signed in, reach it with find_actions and run_read_action.
  • REST: GET /v1/free-tools/account-worth
  • CLI: xholic free-tools account-worth
  • Scope: read
  • Plan: Free tool: no account or plan needed
  • Cost: Live X lookup: no credits, counts toward the plan’s X data limits.
  • Rate limit bucket: live_x

Input

Field Type Required Description
handle string ≤ 120 chars Yes X username, with or without @.

Engagement rate calculator

Section titled “Engagement rate calculator”

free_tools.engagement_calculator · read

Calculate engagement rates from numbers you already have (followers, impressions, likes, replies, reposts, quotes). No X lookup.

  • MCP tool: engagement_calculator. Free tool: loaded on /mcp/free with no account; signed in, reach it with find_actions and run_read_action.
  • REST: GET /v1/free-tools/engagement-calculator
  • CLI: xholic free-tools engagement-calculator
  • Scope: read
  • Plan: Free tool: no account or plan needed
  • Cost: Free.
  • Rate limit bucket: read

Input

Field Type Required Description
followersCount integer 0–1000000000 Yes
impressions integer 0–10000000000 Yes
likes integer 0–1000000000 Yes
replies integer 0–1000000000 Yes
reposts integer 0–1000000000 Yes
quotes integer 0–1000000000 Yes