API documentation # Introduction The Admire.one API gives you full access to creating effective proposals with official API. This documentation describes all of the available API calls and properties of the returned objects. If you have any questions, please reach out to [hello@admire.one.](mailto:hello@admire.one) # Getting Started ## Important! You need a webhook that will receive requests with the result. You can use your own Webhook, [Webhook.site](https://webhook.site/), [Zapier](https://zapier.com) or [Make.com](http://make.com) (former Integromat). Admire.one uses a chain of different artificial intelligence models, the work requires a lot of resources and can sometimes take several minutes. Therefore, we decided not to bother you with constant GET requests, as soon as the result is ready, we will send you a request to your `postback_url`. ## Obtaining an API Key You can get an API Key by authorizing at [rapidapi.com](http://rapidapi.com), it’s free to test 10 request per month. ## Sending your first API call There are four properties that you can include in every API call. 1. `text` Draft of your email or list the main points you want to communicate. AI will then create a letter template based on this information. 2. `linkedin` Your recipient's LinkedIn profile. Our advanced analysis of personal traits allows AI to create a customized, compelling message that is sure to impress. 3. `language` Select the desired language for the proposal [**from the list**](https://admire.one/codes). This may be a different language from what is specified in the variable `text` . 4. `postback_url` Your webhook address, which you’ll get the data. 5. `id` Your request’s id. It’a useful to recognise request id at your postback url. With that in mind, the next step is to send a `POST` with the appropriate values set. ## Example ```json { "text": "Write a selling letter to potential client about about completely free AI service, which write a proposal emails based on personality, decision drivers, ability to say no, risk appetite and provide you all email and phone contacts.", "language": "en", "linkedin": "https://www.linkedin.com/in/williamhgates", "postback_url": "http://your_postback_url.com", "id": "test1" } ``` ## Webhook responses After several minutes after request you’ll get a response at your webhook (`postback_url`) with the schema: ```json { "ai_plain_text": "Dear Bill, We are excited to present you with our completely free AI service, which writes proposal emails tailored to a person's personality, decision drivers, ability to say no, and risk appetite. This service ensures that you will have the heavily informative and relevant emails that you require for success in your business. Additionally, we also provide all email and phone contacts associated with the service. We are confident that our AI system can help you increase your efficiency and relationship building through proposal emails. We look forward to working with you in the near future. All the Best, Your team at the Admire.one", "ai_HTML": "

Dear Bill,

We are excited to present you with our completely free AI service, which writes proposal emails tailored to a person's personality, decision drivers, ability to say no, and risk appetite.

This service ensures that you will have the heavily informative and relevant emails that you require for success in your business. Additionally, we also provide all email and phone contacts associated with the service.

We are confident that our AI system can help you increase your efficiency and relationship building through proposal emails.

We look forward to working with you in the near future.

All the Best,
Your team at the Admire.one

", "profile": { "linkedin": "https://www.linkedin.com/in/williamhgates/", "first_name": "Bill", "last_name": "Gates", "display_name": "Bill Gates", "job": "Co-chair at Bill & Melinda Gates Foundation", "email": "bill@gates.com", "phone": "+1 555 555 555", "opennes": "5.29", "extraversion": "9.37", "emotional": "5.38", "agreeableness": "7.69", "conscientiousness": "5.21" }, "id": "846846396" } ```