Semantir API
Search…
Quick Start
Our API is straightforward and easy to use. All you need to start is our main API endpoint, Bearer Token, and your input data.
Good to know: Most Authorization tokens are limited in scope and depend on the level of access. API with limited scope tokens can generate only a limited number of content with limited throughput. For details about your level of access and your token please reach out at [email protected]

Get your API keys

Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error.
You can get your API key by emailing us at [email protected]

Make your first request

One Endpoint Structure - Any content

You only need one endpoint to generate content for different use cases. The only thing that changes is the request body. For details on what request body to use for different content, check out our Tools section for different use cases. Below is an example of generating product descriptions.
post
https://api.semantir.com/v1/client-generate
Content Generation
Take a look at how you might call our API in Python to generate engaging questions to include inside your landing page.
Python
curl
1
import requests
2
3
url = "https://api.semantir.com/v1/client-generate"
4
5
token = 'YOUR_TOKEN'
6
7
payload = {
8
"inputs": {
9
"var_topic": "Bonaqua",
10
"var_audience": "people that love to drink water",
11
"var_tone": "humorous"
12
},
13
"tool_category": "engaging_questions"
14
}
15
headers = {'Authorization': f'Bearer {token}'}
16
17
response = requests.post(url, headers=headers, json=payload)
18
19
print(response.json())
Copied!
1
curl -X POST "https://api.semantir.com/v1/client-generate" \
2
-H "Authorization: Bearer YOUR_TOKEN" \
3
-H "Content-Type: application/json" \
4
-d "{\"inputs\":
5
{
6
\"var_topic\":\"Bonaqua\",
7
\"var_audience\":\"people that love to drink water\",
8
\"var_tone\":\"humorous\"},
9
\"tool_category\":
10
\"engaging_questions\"
11
}"
Copied!
Continue to our Tools section to learn about other tool categories you can use to generate various content.