Calling Tools

All tool endpoints require the X-Api-Key header. Use the same base URL as platform APIs.

JSON body tools

Text utilities and many SEO tools accept JSON:

curl -X POST "https://api.toolyour.com/api/v1/text-utilities/text-case-converter" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: $API_KEY" \
  -d '{"text":"hello world","case":"uppercase"}'

File upload tools

Convertors and document APIs use multipart/form-data:

curl -X POST "https://api.toolyour.com/api/v1/documents/pdf-to-docx" \
  -H "X-Api-Key: $API_KEY" \
  -F "file=@document.pdf"

Document and media conversion routes follow the same pattern — upload the source file in the file field unless the API reference specifies a different field name (e.g. image for image convertors).

Response formats

Responses vary by tool:

• JSON — text tools, metadata, URLs to download results
• Binary / file stream — some converters return the file directly

Check the specific endpoint in the Tools section of the API reference.

Rate limits

Plans may include per-minute rate limits. Monthly quota is enforced per account (shared across all your API keys). See Usage & Plans.

Errors

See Errors for troubleshooting.