Online Text Reader API: MP3 Over REST

An online text reader API is a REST endpoint that turns a string into an audio file URL — the same job people search as “online reader” or “text reader,” implemented as TTS over HTTP. On Woord that endpoint is POST https://www.getwoord.com/api/convert. Auth is Authorization: Bearer YOUR_KEY. The body is form fields, not JSON: text, gender_voice, language, optional speakingRate and effectsProfileId.

The official docs sample response is {"message":"Your audio has been created!","audio_src":"https://getwoord.s3.amazonaws.com/...mp3","error":false}. Play or download audio_src. Product docs: /pages/api_docs. Starter is $9.99/mo (billed monthly). Config caps each audio at 10,000 characters; an active trial is 8 days with 20,000 characters total and 20,000 characters max per file. The Free plan cannot call this endpoint (API returns an upgrade message).

Request: Hello World as male en_US

curl "https://www.getwoord.com/api/convert" -X POST \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_KEY" \
--data "text=Hello+World&gender_voice=male&language=en_US&speakingRate=1.00&effectsProfileId=telephony-class-application"

That curl is the official docs example. gender_voice is male or female. language is a locale such as en_US. speakingRate 1.00 is 1×. effectsProfileId=telephony-class-application is the telephony profile from the same example.

Response: MP3 URL

Official example from /pages/api_docs:

{
"message": "Your audio has been created!",
"audio_src": "https://getwoord.s3.amazonaws.com/4273352455515882618255eaaf3c1cbdbe0.55443890.mp3",
"error": false
}

error is false on success. audio_src is an S3 HTTPS URL to the MP3. The live converter also returns total_chars and remaining_chars; those two keys are not in the frozen docs sample above. Failure payloads set error: true and a message (quota, validation, invalid argument).

Online reader jobs (same /api/convert)

• Accessibility. Turn article HTML (stripped to text) into an MP3 URL. gender_voice + language are the only required voice knobs in the docs curl.
• LMS / training. Cache audio_src per lesson version. Re-POST only when the source string changes so you do not burn character quota on every student play.
• Not a browser extension. This is REST + S3. The Free plan cannot call the endpoint.

Go live with /api/convert

FAQ: online text reader API

Is the body JSON?

No. The documented curl uses --data form fields. Send application/x-www-form-urlencoded.

Where is the MP3?

In audio_src, an HTTPS URL on getwoord.s3.amazonaws.com. The docs sample filename is a fixture; yours will be a new object key.

Starter vs yearly?

Starter billed monthly is $9.99. The same page’s yearly toggle shows $99.99/year for Starter. Do not mix those two numbers.

Get a key and convert Hello World →