Intelligent API
The Intelligent API provides a unique set of endpoints that a caller can use to perform the following functions:
- Optical Character Recognition on images and documents, including specific functionality to cater for reading identity documentation and expense (receipts / invoices) information.
- Language functions such as detecting the language of a body of text or translating between 75 different languages
- The ability to identify and redact Personally Identifiable Information from bodies of text
- The ability to detect the overall sentiment and summarize bodies of text
Some useful links:
https://api.intelligent-api.com/v1Authentication for the API
Request a token
Request an access token when using OAuth Credentials authentication
Request Body
client_idstringThe client_id generated from the dashboard.
client_secretstringThe client_secret generated from the dashboard.
grant_typestringThe grant type which will always be client_credentials.
scopestringThe list of scopes the token should be generated for separated by a space.
Responses
access_tokenstringThe access_token to be used as the Bearer token when making subsequent API requests.
token_typestringThe type of token that was generated.
expires_inintegerThe amount of time in seconds in which the token expires.
scopestringThe list of scopes the token is valid for separated by a space.
Document Optical Character Recognition (OCR)
Extract expenses
This endpoint allows the caller to POST an image or document that contains expense data such as a receipt or invoice and the endpoint will return a summary of the details as well as a list of items and their prices.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
binaryDatastringThis must be the binary data of the file, for examples on how to post this data to the endpoint please see the Code Examples or try it out in the Playground.
Responses
costCalculationobjectThe cost calculation for the endpoint invocation
receiptsobject[]The list of receipts extracted from the document.
Extract identity
This endpoint allows the caller to POST an image or document that contains identity data such as a passport or drivers license and the endpoint will return the identity details of the person.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
binaryDatastringThis must be the binary data of the file, for examples on how to post this data to the endpoint please see the Code Examples or try it out in the Playground.
Responses
costCalculationobjectThe cost calculation for the endpoint invocation
identityEntitiesobject[]The list of fields extracted
Extract identity field names
Returns the list of possible field names that are returned from the /v1/document/identity endpoint.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Responses
The list of possible field names.
Extract text
This endpoint allows the caller to POST an image or document that contains any text and the endpoint will return the detected text.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
binaryDatastringThis must be the binary data of the file, for examples on how to post this data to the endpoint please see the Code Examples or try it out in the Playground.
Responses
costCalculationobjectThe cost calculation for the endpoint invocation
detectedTextstringAll of the detected text.
detectedLinesstring[]An array of each line of detected text.
Extract text and summarize
This endpoint allows the caller to POST an image or document that contains any text and the endpoint will detect the text and then return a summary of the detected text.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
Responses
costCalculationsobject[]A list of the cost calculations involved in completing the request.
summaryPointsstring[]A list of summary points extracted from the text.
Language
Get the list of supported languages
Returns the list of supported languages for the language endpoints.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Responses
codestringThe language code.
languagestringThe language name.
Detect the languages in the text.
This endpoint allows the caller to POST a body of text containing one or more languages and the endpoint will return the list of languages detected as well as the score indicating the prevalence of the language.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
textstringThe body of text.
Responses
costCalculationobjectThe cost calculation for the endpoint invocation
languagesobject[]The list of languages detected in the body of text.
Translate text from one language to another.
This endpoint allows the caller to POST a body of text specifying the source and target language and the endpoint will return the text in the target language requested.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
textstringThe body of text.
sourceLanguagestringThe source language code, use
autoif the source is unknown.targetLanguagestringThe target language code.
Responses
costCalculationobjectThe cost calculation for the endpoint invocation
textstringThe translated text.
sourceLanguagestringThe source language code.
targetLanguagestringThe target language code.
Media
List items in image
This endpoint allows the caller to POST an image and the endpoint will return a list of items detected within the image.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
binaryDatastringThis must be the binary data of the file, for examples on how to post this data to the endpoint please see the Code Examples or try it out in the Playground.
Responses
costCalculationobjectThe cost calculation for the endpoint invocation
itemsstring[]The list of items detected in the image.
Image calorie count
This endpoint allows the caller to POST an image and the endpoint will return a list of food and drink items and their calorie and macro counts found in the image.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
binaryDatastringThis must be the binary data of the file, for examples on how to post this data to the endpoint please see the Code Examples or try it out in the Playground.
Responses
costCalculationobjectThe cost calculation for the endpoint invocation
calorieCounterResultobject
Text calorie count
This endpoint allows the caller to POST a body of text containing food and drink items and the endpoint will return the list of items and their calorie and macro counts.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
textstringThe body of text.
Responses
costCalculationobjectThe cost calculation for the endpoint invocation
calorieCounterResultobject
Classify text
This endpoint allows the caller to POST a body of text and list of possible classifications and it will return back the classification of the text.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
textstringThe text to classify.
classificationsstring[]
Responses
costCalculationobjectThe cost calculation for the endpoint invocation
classificationstringThe classification of the item.
Classify multiple text items
This endpoint allows the caller to POST a list of text items and list of possible classifications and it will return back the classification of each item in the text list.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
itemsstring[]The list of text items to classify.
classificationsstring[]
Responses
costCalculationobjectThe cost calculation for the endpoint invocation
itemsobject[]optionalThe list of items and their classifications.
Extract expenses from text
This endpoint allows the caller to POST a body of text containing expense data and an optional list of categories. The endpoint will return a list of items with their amounts and categories.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
textstringThe body of text containing expense data.
classificationsstring[]optionalThe list of categories to classify each expense item into.
Responses
costCalculationobjectThe cost calculation for the endpoint invocation
itemsobject[]The list of expense items extracted from the text.
Extract todo from text
This endpoint allows the caller to POST a body of text along with the user's current date, day, and time and the endpoint will extract a todo item and suggest a reminder date and time.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
textstringThe body of text containing the todo item.
usersDatestringoptionalThe user's current date in DD/MM/YYYY format.
usersDaystringoptionalThe user's current day of the week.
usersTimestringoptionalThe user's current time.
Responses
costCalculationobjectThe cost calculation for the endpoint invocation
todoobject
Transcribe audio
Transcribe the audio and return the text.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
filestringThe audio file to transcribe. Supported formats include OGG, MP3, WAV, FLAC, and M4A.
Responses
costCalculationobjectThe cost calculation for the endpoint invocation
speechstringThe transcribed text from the audio file.
Extract todo from audio
This endpoint allows the caller to POST an audio file along with the user's current date, day, and time as query parameters. The endpoint will transcribe the audio and extract a todo item with a suggested reminder date and time.
query Parameters
user_datestringThe user's current date in DD/MM/YYYY format.
user_daystringThe user's current day of the week.
user_timestringThe user's current time.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
filestringThe audio file to transcribe. Supported formats include OGG, MP3, WAV, FLAC, and M4A.
Responses
costCalculationsobject[]A list of the cost calculations involved in completing the request.
todoobjectspeechstringThe transcribed text from the audio file.
Calorie count from audio
This endpoint allows the caller to POST an audio file containing food and drink items. The endpoint will transcribe the audio and return a list of items with their calorie and macro counts.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
filestringThe audio file to transcribe. Supported formats include OGG, MP3, WAV, FLAC, and M4A.
Responses
costCalculationsobject[]A list of the cost calculations involved in completing the request.
calorieCounterResultobjectspeechstringThe transcribed text from the audio file.
Extract expenses from audio
This endpoint allows the caller to POST an audio file containing expense data and an optional comma-separated list of categories as a query parameter. The endpoint will transcribe the audio and return a list of items with their amounts and categories.
query Parameters
classificationsstringA comma-separated list of categories to classify each expense item into.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
filestringThe audio file to transcribe. Supported formats include OGG, MP3, WAV, FLAC, and M4A.
Responses
costCalculationsobject[]A list of the cost calculations involved in completing the request.
itemsobject[]The list of expense items extracted from the audio.
speechstringThe transcribed text from the audio file.
Personally Identifiable Information (PII)
Get the list of supported languages
Returns the list of supported languages for the Personally Identifiable Information (PII) endpoints.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Responses
codestringThe language code.
languagestringThe language name.
Detect Personally Identifiable Information (PII)
This endpoint allows the caller to POST a body of text and the source language and the endpoint will then detect any Personally Identifiable Information (PII) within the text and return the locations of any possible Personally Identifiable Information (PII).
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
textstringThe body of text.
languagestringThe source language code.
Responses
costCalculationobjectThe cost calculation for the endpoint invocation
entitiesobject[]The PII entities detected in the text.
Redact Personally Identifiable Information (PII)
This endpoint allows the caller to POST a body of text and the source language and the endpoint will then detect any Personally Identifiable Information (PII) within the text and return the text with any Personally Identifiable Information (PII) redacted.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
textstringThe body of text.
languagestringThe source language code.
minimumScorenumberoptionalThe minimum score for which to redact the PII entities.
Responses
costCalculationobjectThe cost calculation for the endpoint invocation
textstringThe text with the PII entities redacted.
Text
Get the list of supported languages
Returns the list of supported languages for the sentiment endpoints.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Responses
codestringThe language code.
languagestringThe language name.
Detect text sentiment
This endpoint allows the caller to POST a body of text and the source language and the endpoint will return the sentiment score of the text.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
textstringThe body of text.
languagestringThe source language code.
Responses
costCalculationobjectThe cost calculation for the endpoint invocation
sentimentstringThe overall sentiment of the text.
sentimentScoreobject
Summarize text
This endpoint allows the caller to POST a body of text and the endpoint will return a summary of the text.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
textstringThe body of text.
Responses
costCalculationobjectThe cost calculation for the endpoint invocation
summaryPointsstring[]The list of summary points.
Web Scraper
Markdown web page
Extract and converts the contents of a web page to markdown.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
urlstringThe url of the webpage.
proxystringoptionalIf required, the complete uri of the server to proxy the request through.
Responses
costCalculationobjectThe cost calculation for the endpoint invocation
markdownstringoptionalThe markdown of the web page.
Summarize web page
Extract and summarize the contents of a web page.
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.X-Correlation-IdstringIf you would like to correlate any API requests made with any errors that may be returned, pass in this header and the system will log the id with all requests internally.
User-AgentstringYou can pass in the User Agent for any custom integration you build to identify the caller, for example if you are integrating your own different APIs you can set the user agent to identify which calls originate from which API.
Request Body
urlstringThe url of the webpage.
proxystringoptionalIf required, the complete uri of the server to proxy the request through.
Responses
costCalculationsobject[]A list of the cost calculations involved in completing the request.
summaryPointsstring[]A list of summary points extracted from the web page.
System functions
Get the client balance
Get the client balance
Headers
AuthorizationrequiredstringEither Oauth Authentication using a
Bearertoken or Basic Authentication using aBasicapi key.
Responses
availableCreditsintegerThe total number of available credits.
lowThresholdWarningintegerThe current setting of the Low Balance Threshold warning, to change this please see Updating Low Balance Threshold
updatedAtstringThe datestamp when the balance was last updated.