Skip to main content
TruthScan logo
  • Category: artificial intelligence
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 8
  • Triggers: 0
  • Slug: TRUTHSCAN
  • Version: 20261101_00

Tools

Slug: TRUTHSCAN_ANALYZE_AUDIOSubmit exactly one public audio URL or uploaded audio/media file for AI-generation detection. By default, analyze up to the first 60 seconds and wait with bounded polling for the latest result; submission consumes account credits.

Input Parameters

string
Publicly reachable audio or supported media URL to analyze.
object
Audio or media attachment to upload directly. Supported extensions are mp3, wav, m4a, flac, ogg, and mp4; the provider accepts files from 1 KB through 100 MB.
number
Maximum total polling time in seconds (1-600). On timeout, the latest nonterminal status and job ID are returned for later resumption.
boolean
Poll until the analysis is done or failed. Set false to return the accepted job immediately.
integer
Maximum leading duration to analyze, in seconds.
number
Seconds between result checks while waiting (1-60).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRUTHSCAN_ANALYZE_IMAGESubmit an image URL for AI-generation detection and, by default, wait for the asynchronous result. Returns the job ID when not waiting or when polling times out; detection consumes account credits.

Input Parameters

string
TruthScan model name; use generic unless a specific instance/model is known.
string
required
Publicly reachable image URL (1 KB-10 MB) to analyze.
number
Maximum total wait time in seconds (up to 600); on timeout return the current pending status and job ID for later resumption.
boolean
Generate a secured detection heatmap.
boolean
Generate a secured preview asset for later download.
boolean
Poll until done or failed; set false to return immediately with the job ID.
number
Seconds between result checks when waiting (minimum 1).
boolean
Include detailed analysis indicators in the completed result.
boolean
Override generation of the overlay heatmap variant; omit to use the provider default, and do not set true when generate_heatmap is false.
boolean
Include content-moderation signals in the analysis.
boolean
Override generation of the normalized heatmap variant; omit to use the provider default, and do not set true when generate_heatmap is false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRUTHSCAN_ANALYZE_PDFSubmit a publicly reachable HTTPS PDF URL for asynchronous tampering detection via the text detector host and, by default, wait for a result. Each page costs 1,000 credits; returned fields omit the provider’s PDF summary and modules.

Input Parameters

string ("pdf_detector" | "pdf_detector/v1" | "pdf_detector/v3" | "pdf_detector/v4")
PDF detector version. Use pdf_detector/v4 for current tampering detection; v1 focuses on AI-generation fingerprints and v3 on structural tampering.
string
required
Publicly reachable HTTPS URL ending in .pdf. The PDF must be no larger than 2 MB; analysis costs 1,000 credits per page.
number
Maximum total wait time in seconds. On timeout, returns the latest pending status and document ID so the job can be resumed later.
boolean
Poll until done or failed; set false to return immediately with the document ID.
number
Seconds between result checks when waiting (minimum 1).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRUTHSCAN_ANALYZE_TEXTSubmit a text value or public web URL for AI-written-text detection. Provide one input source and never both. By default, wait for the asynchronous result; detection consumes account credits.

Input Parameters

string
Publicly reachable web URL whose text should be analyzed. Required when text is omitted; do not provide both fields.
string
Text to analyze, under 30,000 words; at least 200 words is recommended. Required when url is omitted; do not provide both fields.
string
TruthScan text detector model.
number
Maximum total wait in seconds (1-300). On timeout, return the latest pending status and document ID for later resumption.
boolean
Poll until the detection is done or failed. Set false to return immediately with the document ID.
number
Seconds between result checks when waiting (1-60).
boolean
Include deeper source and analysis signals when supported.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRUTHSCAN_ANALYZE_VIDEOAnalyze exactly one public video URL or uploaded video for AI generation or face swapping. By default, wait with bounded polling and return the latest result; this non-idempotent submission consumes account credits.

Input Parameters

string ("generic" | "faceswap")
Detection model: generic detects AI-generated video, while faceswap detects face swapping.
string
Publicly reachable video URL to analyze.
object
Video attachment to upload directly. Supported extensions are mp4, mov, avi, mkv, and webm; the provider accepts files from 1 KB through 100 MB.
number
Maximum total polling time in seconds (1-600). On timeout, the latest nonterminal status and job ID are returned for later resumption.
boolean
Generate a preview when the selected detector supports one.
boolean
Poll until the analysis is done or failed. Set false to return the accepted job immediately.
number
Seconds between result checks while waiting (4-60). Video has a low request limit, so shorter intervals are rejected.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRUTHSCAN_CHECK_CREDITSReturn the connected TruthScan account’s remaining detection credits from the canonical image detector balance endpoint.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRUTHSCAN_DOWNLOAD_IMAGE_ASSETDownload a generated preview or heatmap for an owned TruthScan image detection job. Returns a managed file when ready, or an explicit pending or unavailable state.

Input Parameters

string
required
Sensitive image document/job ID returned by Analyze Image.
string ("preview" | "heatmap")
required
Generated image asset to download: preview or heatmap.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRUTHSCAN_GET_DETECTION_RESULTGet the current status and available results of an existing image, text, PDF, video, or audio detection job without submitting another analysis. Optionally poll until the job finishes or the wait times out. PDF results do not include the provider’s summary or module details.

Input Parameters

string
required
Sensitive document or job ID returned by a TruthScan analysis tool.
string ("image" | "text" | "pdf" | "video" | "audio")
required
Detector that created the job. Text and PDF share a host but retain distinct result semantics.
number
Maximum total wait in seconds (1-300).
boolean
Poll until done or failed instead of returning the current status once.
number
Seconds between checks when waiting (1-60). Video requires at least 4 seconds because its query limit is lower.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not