> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OneSimpleAPI

> OneSimpleAPI provides utility APIs for web content, images, PDFs, QR codes, URL management, validation, exchange rates, and file management.

![OneSimpleAPI logo](https://mintcdn.com/composio-preview/gqjBKmmJCINafaiK/images/toolkits/onesimpleapi.svg?fit=max\&auto=format\&n=gqjBKmmJCINafaiK\&q=85\&s=df3a90ef1e93bc7382f7a8cd36f5f7ba)

* **Category:** developer tools
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 15
* **Triggers:** 0
* **Slug:** `ONESIMPLEAPI`
* **Version:** 20261030\_00

## Tools

> [accordion] Analyze Readability
>
> **Slug:** `ONESIMPLEAPI_ANALYZE_READABILITY`
>
> Analyze text for readability, grade level, reading time, difficult-word counts, and sentiment.
>
> #### Input Parameters
>
> **text** `string` *required*
>
> Text to analyze for readability, reading time, and sentiment.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Calculate PPP Discount
>
> **Slug:** `ONESIMPLEAPI_CALCULATE_PPP_DISCOUNT`
>
> Calculate a purchasing-power-parity discount and localized price between an origin and a destination country.
>
> #### Input Parameters
>
> **price** `number` *required*
>
> Positive base price to localize.
>
> **max\_discount** `number`
>
> Maximum discount percentage.
>
> **destination\_user\_ip** `string`
>
> Destination user's IPv4 or IPv6 address. Provide exactly one of this field or destination\_country\_code.
>
> **origin\_country\_code** `string` *required*
>
> Two-letter ISO country code where the base price applies.
>
> **destination\_country\_code** `string`
>
> Two-letter ISO destination country code. Provide exactly one of this field or destination\_user\_ip.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Capture Screenshot
>
> **Slug:** `ONESIMPLEAPI_CAPTURE_SCREENSHOT`
>
> Capture a webpage URL or raw HTML as a hosted screenshot and return its URL and rendering metadata.
>
> #### Input Parameters
>
> **url** `string`
>
> Public webpage URL to capture; provide this or html.
>
> **html** `string`
>
> Raw HTML to capture; provide this or url.
>
> **force** `boolean`
>
> Force a fresh capture rather than reuse a cached result.
>
> **screen** `string`
>
> Viewport preset (retina, phone, phone-landscape, tablet, tablet-landscape, 4k, or 8k) or custom:WIDTHxHEIGHT in pixels.
>
> **full\_page** `boolean`
>
> Capture the full scrollable page rather than only the viewport.
>
> **background** `boolean`
>
> Include page background rendering.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Convert Currency
>
> **Slug:** `ONESIMPLEAPI_CONVERT_CURRENCY`
>
> Convert an amount between supported currencies and return the converted value and exchange rate.
>
> #### Input Parameters
>
> **from\_value** `number`
>
> Amount in the source currency to convert.
>
> **to\_currency** `string` *required*
>
> Three-letter destination currency code, such as EUR.
>
> **from\_currency** `string`
>
> Three-letter source currency code.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Short URL
>
> **Slug:** `ONESIMPLEAPI_CREATE_SHORT_URL`
>
> Create a OneSimpleAPI short URL with optional one-time-use, redirect, query-forwarding, and active-date controls.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> Destination HTTP or HTTPS URL.
>
> **end\_date** `string`
>
> Optional ISO date when the short URL stops being active.
>
> **single\_use** `boolean`
>
> Whether the short URL should work only once.
>
> **start\_date** `string`
>
> Optional ISO date when the short URL becomes active.
>
> **forward\_params** `boolean`
>
> Whether incoming query parameters should be forwarded to the destination.
>
> **temporary\_redirect** `boolean`
>
> Whether redirects should be temporary rather than permanent.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete File
>
> **Slug:** `ONESIMPLEAPI_DELETE_FILE`
>
> Delete a generated OneSimpleAPI file by its hosted URL and return the updated file record.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> Generated file URL returned by a creation tool or List Files.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Expand Short URL
>
> **Slug:** `ONESIMPLEAPI_EXPAND_SHORT_URL`
>
> Resolve a shortened URL and return its final URL, redirect count, and redirect trace.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> Shortened HTTP or HTTPS URL to resolve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate or Convert Color
>
> **Slug:** `ONESIMPLEAPI_GENERATE_OR_CONVERT_COLOR`
>
> Generate a deterministic color palette from text or convert a supplied color into HEX, RGB, HSL, and related palette values.
>
> #### Input Parameters
>
> **hue** `number`
>
> Optional palette hue adjustment from 0 through 360.
>
> **text** `string`
>
> Text used to deterministically generate a color and palette; provide this or color.
>
> **color** `string`
>
> HEX or rgb() color to convert; provide this or text.
>
> **lightness** `number`
>
> Optional palette lightness adjustment from 0 through 1.
>
> **saturation** `number`
>
> Optional palette saturation adjustment from 0 through 1.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate PDF
>
> **Slug:** `ONESIMPLEAPI_GENERATE_PDF`
>
> Generate a PDF from either a webpage URL or raw HTML and return the hosted PDF URL and page metadata.
>
> #### Input Parameters
>
> **url** `string`
>
> Public webpage URL to convert; provide this or html.
>
> **html** `string`
>
> Raw HTML to convert. Use this instead of url; do not provide both fields.
>
> **page** `string ("Letter" | "Legal" | "Tabloid" | "Ledger" | "A0" | "A1" | "A2" | "A3" | "A4" | "A5" | "A6")`
>
> PDF page size.
>
> **force** `boolean`
>
> Force regeneration rather than reuse a cached result.
>
> **background** `boolean`
>
> Include page backgrounds in the PDF; disabled by default.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate QR Code
>
> **Slug:** `ONESIMPLEAPI_GENERATE_QR_CODE`
>
> Generate a hosted PNG or SVG QR code for a message and return its URL.
>
> #### Input Parameters
>
> **size** `string ("small" | "medium" | "large")`
>
> Generated QR code size.
>
> **color** `string`
>
> Foreground color in hexadecimal, RGB, or RGBA notation.
>
> **format** `string ("png" | "svg")`
>
> Generated image format.
>
> **message** `string` *required*
>
> Text, URL, phone number, or other message to encode in the QR code.
>
> **background** `string`
>
> Background color in hexadecimal, RGB, or RGBA notation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Image Information
>
> **Slug:** `ONESIMPLEAPI_GET_IMAGE_INFORMATION`
>
> Extract dimensions, image metadata, EXIF camera fields, and available GPS details from an image URL. Returned fields vary with the metadata embedded in the image.
>
> #### Input Parameters
>
> **raw** `boolean`
>
> Whether to include raw metadata in addition to normalized fields.
>
> **url** `string` *required*
>
> Publicly reachable image URL to inspect.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Files
>
> **Slug:** `ONESIMPLEAPI_LIST_FILES`
>
> Return one page of generated files owned by the connected account, optionally filtered by live or deleted status.
>
> #### Input Parameters
>
> **status** `string ("live" | "deleted")`
>
> Optional lifecycle status to filter files by.
>
> **next\_cursor** `string`
>
> Cursor from a previous response; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Short URLs
>
> **Slug:** `ONESIMPLEAPI_LIST_SHORT_URLS`
>
> Return one page of OneSimpleAPI short URLs and their click statistics.
>
> #### Input Parameters
>
> **next\_cursor** `string`
>
> Cursor from a previous response; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Transform Image
>
> **Slug:** `ONESIMPLEAPI_TRANSFORM_IMAGE`
>
> Resize, crop, rotate, flip, filter, border, optimize, and host an image, returning the generated image URL and metadata.
>
> #### Input Parameters
>
> **crop** `string`
>
> Crop size, such as 200x150, or a supported social-media size.
>
> **flip** `string ("v" | "h" | "vh")`
>
> Flip vertically, horizontally, or on both axes.
>
> **page** `integer`
>
> One-based page number to convert when the source is a multi-page PDF.
>
> **size** `string`
>
> Output size, such as 200x150, 200w, 150h, or a supported social-media size.
>
> **force** `boolean`
>
> Whether to regenerate the image instead of reusing a cached transform.
>
> **image** `string` *required*
>
> Source image URL or provider-supported base64 image value.
>
> **border** `integer`
>
> Border width in pixels.
>
> **crop\_x** `number`
>
> Horizontal crop coordinate used with offset or focal crop mode.
>
> **crop\_y** `number`
>
> Vertical crop coordinate used with offset or focal crop mode.
>
> **format** `string ("webp" | "jpg" | "png")`
>
> Generated image format.
>
> **rotate** `string ("auto" | "90" | "180" | "270")`
>
> Rotation to apply to the generated image.
>
> **filters** `string`
>
> Comma-separated filters: grayscale, sepia, or name:value using blur and sharpen from 0 to 100, brightness and contrast from -100 to 100, gamma from 0.01 to 9.99, or pixelate from 0 to 1000.
>
> **optimize** `boolean`
>
> Whether to optimize the generated image for size and performance.
>
> **crop\_mode** `string ("top" | "top-left" | "top-right" | "center" | "center-left" | "center-right" | "bottom" | "bottom-left" | "bottom-right" | "offset" | "focal")`
>
> Crop strategy, such as center, top-left, offset, or focal. Use offset or focal with crop\_x and crop\_y.
>
> **resize\_mode** `string ("contain" | "size-limit" | "forced")`
>
> How to fit the source into the requested size.
>
> **border\_color** `string`
>
> Border color as an HTML color name or hexadecimal color.
>
> **border\_method** `string ("overlay" | "expand" | "shrink")`
>
> How the border affects the output image dimensions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Validate Email
>
> **Slug:** `ONESIMPLEAPI_VALIDATE_EMAIL`
>
> Validate an email address and assess its domain, MX records, deliverability, disposability, role status, and registration safety.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Email address to validate.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
