The Syntax IQ API is RESTful and allows you to communicate with all features of Syntax IQ using HTTP requests. All responses return JSON objects, including errors.
The Syntax IQ API supports authentication via an API Key. You must provide your
api_key for every request.
You can grab your API key from your account.
Only one API key is active at a time. Take care to keep your API key secret!
To ensure data privacy, all API requests must be made over HTTPS. Unencrypted requests made over plain HTTP are not supported.
HTTP Status Code Summary
200 OK - Everything worked as expected.
400 Bad Request - We couldn’t understand your request. Typically missing a parameter.
401 Unauthorized - Either no authentication credentials were provided or they are invalid.
402 Payment Required - Account does not have enough credit to perform request.
429 Too Many Requests - You’ve hit the rate limit, wait a bit.
500 Server Error - Something unexpected happened on our end.
When you a receive a response with a status code in the 4xx or 5xx range, you’ll receive a JSON object in the body with details. The object will have a
message key, like so:
"message": "Our servers are busy right now, please try again!"
Each account can only make 5 requests per second. If you need more mail us at [email protected].
Generate Content POST
- Product Descriptions - model50_pd
- Instagram Captions - model50_ig
Language: If there's no language option provided it defaults to the user's language provided during registration.
Most language code parameters conform to ISO-639-1 identifiers, except where noted. A list of supported languages can be found here
$ curl --request POST --url 'https://api.syntaxiq.com/v1/describe?api_key=$API_KEY'
--header 'content-type: multipart/form-data;'
--form '[email protected]/to/local/file'
"content": "Content here"