Generates new copy in an existing content plan
This endpoint consumes between 1 to 4 generations each time it is called, depending on the tool.
Call /api/generations or visit the API Dashboard to see how many generation credits you have.
Pass your API Key as a Bearer Token.
This endpoint has no request query parameters.
The request body for this endpoint is a JSON payload with the following keys:
Key | Description | Type | Example |
---|---|---|---|
tool_id | ID of Tool, see /api/toolsrequired | String | "ZVJReZgVn" |
... | All required fields of toolrequired | Mixed | Get the required fields from /api/tools endpoint |
webhook_url | URL of Webhook, POST request is sent after text is generated | String | "https://a-cool-webhook.com" |
language | Object containing id and formality of language your want your copy to be in. Defaults to English if left empty. | Object | |
language.id | ID of language, see /api/languages Defaults to English if left empty. | String | "deepl_PT-BR" |
language.formality | Formalness of text, only works with select languages and DeepL. Acceptable values are "more", "less", or "default". | String | "more" |
Here's an example of the body parameters represented as a JSON object.
{
"tool_id": "ZVJReZgVn",
"post_title": "Whats the cheapest way to get to Brazil?",
"tone": "helpful and professional",
"webhook_url": "https://a-cool-webhook.com",
"language": {
"id": "deepl_PT-BR",
"formality": "more"
}
}
Command Line (curl)
curl -X POST "https://nichesss.com/api/content-plans/<CONTENT_PLAN_ID>/append" -H "Content-type: application/json" -H "Authorization: Bearer <YOUR_API_KEY>" -d "{\"tool_id\":\"ZVJReZgVn\",\"post_title\":\"Whats the cheapest way to get to Brazil?\",\"tone\":\"helpful and professional\",\"webhook_url\":\"https://a-cool-webhook.com\",\"language\":{\"id\":\"deepl_PT-BR\",\"formality\":\"more\"}}"
JavaScript
fetch('https://nichesss.com/api/content-plans/<CONTENT_PLAN_ID>/append', {
method: 'POST',
headers: {
'Content-type': 'application/json',
'Authorization': 'Bearer <YOUR_API_KEY>',
},
body: JSON.stringify({"tool_id":"ZVJReZgVn","post_title":"Whats the cheapest way to get to Brazil?","tone":"helpful and professional","webhook_url":"https://a-cool-webhook.com","language":{"id":"deepl_PT-BR","formality":"more"}})
})
.then((response) => response.json())
.then((data) => console.log(data));
Python
import requests
url = 'https://nichesss.com/api/content-plans/<CONTENT_PLAN_ID>/append'
payload = {"tool_id":"ZVJReZgVn","post_title":"Whats the cheapest way to get to Brazil?","tone":"helpful and professional","webhook_url":"https://a-cool-webhook.com","language":{"id":"deepl_PT-BR","formality":"more"}}
headers = {'Content-type': 'application/json', 'Authorization': 'Bearer <YOUR_API_KEY>'}
response = requests.post(url, json=payload, headers=headers)
data = response.json()
print(data)
PHP
$api_key = '<YOUR_API_KEY>';
$request_url = 'https://nichesss.com/api/content-plans/<CONTENT_PLAN_ID>/append';
$request_options = array(
'http' => array(
'method' => 'POST',
'header' => 'Content-type: application/json' . "\r\n" .
'Authorization: Bearer ' . $api_key . "\r\n",
'content' => '{"tool_id":"ZVJReZgVn","post_title":"Whats the cheapest way to get to Brazil?","tone":"helpful and professional","webhook_url":"https://a-cool-webhook.com","language":{"id":"deepl_PT-BR","formality":"more"}}'
)
);
$request_context = stream_context_create($request_options);
$request_result = file_get_contents($request_url, false, $request_context);
$data = json_decode($request_result);
echo $data;
Ruby
require 'net/http'
require 'json'
uri = URI('https://nichesss.com/api/content-plans/<CONTENT_PLAN_ID>/append')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri.request_uri)
request['Content-type'] = 'application/json'
request['Authorization'] = 'Bearer <YOUR_API_KEY>'
request.body = {"tool_id":"ZVJReZgVn","post_title":"Whats the cheapest way to get to Brazil?","tone":"helpful and professional","webhook_url":"https://a-cool-webhook.com","language":{"id":"deepl_PT-BR","formality":"more"}}.to_json
response = http.request(request)
puts JSON.parse(response.body)
All responses from the API are JSON. You won't get the copy back immediately. We recommended you use webhooks to get your copy back, or follow the queue uri and wait.
{
"success": true,
"message": "Proccessing your copy now.",
"queue_uri": "https://nichesss.com/api/content-plans/queue/iYTJno4Rr4hHWHHC8zDmYQtC2",
"queue_id": "iYTJno4Rr4hHWHHC8zDmYQtC2"
}