VitaCloud Quotes (Preview)
A daily dose of inspirational quotes delivered to you application or website. Choose from a variety of themes and authors.
This connector is available in the following products and regions:
Service | Class | Regions |
---|---|---|
Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
Contact | |
---|---|
Name | VitaCloud Support |
URL | https://www.vitacloud.co.uk |
support@vitacloud.co.uk |
Connector Metadata | |
---|---|
Publisher | VitaCloud Limited |
Website | https://www.vitacloud.co.uk |
Privacy policy | https://www.vitacloud.co.uk/PrivacyPolicy |
Categories | Lifestyle and Entertainment;Productivity |
VitaCloud Quotes API provides a curated set of quotes by famous authors and celebrities, tagged with various themes such as faith, god, happiness, hope, humour, inspiration, knowledge, life lessons, love, motivation, philosophy, poetry, relationship, religion, romance, science, time, truth, and wisdom. VitaCloud Quotes API connector is a wrapper around the VitaCloud Quotes API that enables bringing the tailored, daily and random VitaCloud Quotes into your workspace using Microsoft Power Automate, Microsoft Power Apps, and Azure Logic Apps in your Azure and Office 365 subscription.
You will need the following to proceed:
- A VitaCloud API Base URL
- A VitaCloud API Key
- A Microsoft Power Apps or Power Automate plan with custom connector feature
This video walks through the process of subscribing to the VitaCloud Quotes APIs and retrieving the sibscription keys and the Base URL require to integrate the APIs in your products and in the official Office 365 connector and web parts.
Sign up or log in to the VitaCloud API Portal
Subscribe to one of the free or paid products from the Product catalog
Select the subscribed product in the portal and copy the Base Product URL
Click the Profile menu and in the Subscriptions section, select the same product, click the Show button for the primary or secondary key and copy it. This is your API Key
The Base Product URL and API Key will be required for connecting to the Quotes connector in Power Automate and Power Apps.
Select an action from the VitaCloud Quotes connector in Power Automate.
If using the connector for the first time, you will be prompted to provide the following details to create a connection.
- Connection name. Give a unique name for your connection. E.g. VitaCloud Quotes
- Base Product URL. See video and steps to generate the API Base URL in the above section.
- API Key. See video and steps to generate the API Key in the above section.
Provide any parameters for the selected action, if prompted.
Get Authors and Get Themes actions can be used to get the available authorTags and themeTags.
Consume the output in downstream actions, such as compose and post an adaptive card to a Team's channel or Group chat
or post to a mailbox.
The connector can also be used in Power Apps.
- Please note some functionality may be limited based on the subscribed product. E.g. if only VitaCloud Free Quotes product is subscribed, then only the Get Today's Quote and Get Random Quote actions will work in the connector.
- We recommend subscribing to the VitaCloud Quotes Premium or VitaCloud Quotes Ultimate product based on your call quota limits to unlock all options in the connector.
- If number of quotes is not specified for operations requiring them, then at most 5 quotes will be returned in the response.
- Number of quotes returned will be limited to a maximum of 10.
- Some authors may not have a corresponding Wikipedia link.
- Author images are subject to change, but will maintain the same size and aspect ratio.
If an incorrect Base Product URL or API Key is specified, HTTP status code
404 - not found
will be returned, alongwith a response as below
{"requestId": long string, "message": "No data product found. Please contact your data provider"}
Please update the connection with the correct Base Product URL and API Key from the API portal. Please see the above video.If an action is used that is not included in the product corresponding to the Base Product URL, HTTP status code
403 - forbidden
will be returned, alongwith a response as below
{"requestId": long string, "message": "Endpoint not available"}
Update the connection with the Base Product URL corresponding to the product containing the requested endpoint.
How can I consume the APIs directly in a website or app?
Download the OpenAPI 3.0 specification for your subscribed API on the API tab for your product.
Please include the API key in the header for your request to the endpoints. Select an endpoint in the API tab to try out a request in the portal.What themes and authors are included? The Quotes connector
Get Themes
action provides over 20 themes to choose from, including popular ones like humour, wisdom, science, inspiration, philosophy and happiness. TheGet Authors
action provides details for over 700 authors, personalities and celebrities. Most endpoints also include authors' images and wikipedia links, where available.
Where can I reach out if I have a product query or require support?
Please send your query to VitaCloud Support or fill out the contact form on the VitaCloud Website.
The connector supports the following authentication types:
Default | Parameters for creating connection. | All regions | Not shareable |
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
Name | Type | Description | Required |
---|---|---|---|
Base Product URL | string | https://apis.vitacloud.co.uk or https://apis.vitacloud.co.uk/free | True |
API Key | securestring | Your subscription Key | True |
Name | Calls | Renewal Period |
---|---|---|
API calls per connection | 100 | 60 seconds |
Get 5 random quotes |
Sample request: GET /Quotes |
Get 5 random quotes for an author |
Sample request: GET /Quotes/Author/aamilne,mahatmagandhi |
Get a random quote |
Sample request: GET /Quotes/random |
Get a specified number of random quotes |
Sample request: GET /Quotes |
Get a specified number of random quotes for a theme |
Sample request: GET /Quotes/Theme/love,inspiration/5 |
Get a specified number of random quotes for an author |
Sample request: GET /Quotes/Author/aamilne/5 |
Get all authors |
Sample request: GET /Authors |
Get all themes |
Sample request: GET /Themes |
Get an author |
Sample request: GET /Authors/aamilne |
Get today's quote |
Sample request: GET /Quotes/today |
Gets a theme |
Sample request: GET /Themes/happiness |
Gets up to 5 random quotes for a theme |
Sample request: GET /Quotes/Theme/love Or GET /Quotes/Theme/love,inspiration |
Sample request: GET /Quotes/Author/aamilne,mahatmagandhi
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Author Tag
|
authortag | True | string |
Author's tag or a comma separated list of author tags |
Returns
- response
- array of VwQuote
Sample request: GET /Quotes
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Number of quotes (max 10)
|
number | True | integer |
Number of random quotes to return (max 10) |
Returns
- response
- array of VwQuote
Sample request: GET /Quotes/Theme/love,inspiration/5
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Theme Tag
|
themetag | True | string |
Theme tag or a comma separated list of them tags. |
Number of quotes (max 10)
|
number | True | integer |
Number of random quotes to return (max 10) |
Returns
- response
- array of VwQuote
Sample request: GET /Quotes/Author/aamilne/5
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Author Tag
|
authortag | True | string |
Author's tag or a comma separated list of author tags |
Number of quotes (max 10)
|
number | True | integer |
Number of random quotes to return (max 10) |
Returns
- response
- array of VwQuote
Sample request: GET /Authors/aamilne
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Author Tag
|
authortag | True | string |
Author tag. For a list of available author tags, use the Get all authors action |
Returns
- Author
- VwAuthor
Sample request: GET /Themes/happiness
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Theme Tag
|
themetag | True | string |
Theme tag. For a list of available theme tags, use the Get all themes action |
Returns
- Theme
- VwTheme
Sample request: GET /Quotes/Theme/love Or GET /Quotes/Theme/love,inspiration
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Theme Tag
|
themetag | True | string |
Theme tag or a comma separated list of them tags |
Returns
- response
- array of VwQuote
Name | Path | Type | Description |
---|---|---|---|
Tag
|
AuthorTag | string |
Author's Tag |
Name
|
AuthorName | string |
Author's Name |
Image
|
AuthorImage | string |
Author's Image |
Link
|
AuthorLink | string |
Author's Wikipedia Link |
Name | Path | Type | Description |
---|---|---|---|
Author Tag
|
AuthorTag | string |
Author's Tag |
Author Name
|
AuthorName | string |
Author's Name |
Author Image
|
AuthorImage | string |
Author's Image |
Author Link
|
AuthorLink | string |
Author's Wikipedia Link |
Text
|
Quote | string |
Quote Text |
Length
|
Length | integer |
Quote Length |
Theme Tag
|
ThemeTag | string |
Theme tag |
Theme Name
|
ThemeName | string |
Theme Name |
Name | Path | Type | Description |
---|---|---|---|
Tag
|
ThemeTag | string |
Theme tag |
Name
|
ThemeName | string |
Theme Name |
Number of quotes
|
ThemeQuotes | integer |
Number of quotes |