logo
Feature Endpoint
AutoBlog
POST

/custom/api/generate/one/click/blog

If no response is received here due to the extended generation time required by this API, we suggest utilizing a local API platform such as Postman or directly accessing the API through your project.

Headers

Authorizationrequired
string

Input the Authorization Bearer Token to authorize your API request.

Body

topicrequired
string

This input field requires the user to mention the topic they wish to write on. Example: “Lithium Ion discovery in India” OR “Bard: Google answer to ChatGPT”

descriptionrequired
string

This input field requires the user to elaborate on the topic they wish to write on. Example: “Showcase the future of manufacturing in India, following Lithium Ion discovery.”

blog_typerequired
Default: "listicle"
string

This input field defines the type of blog you wish to generate.

Available blog_type are:

  1. 1.  how_to: A step-by-step guide on a particular topic.
  2. 2.  listicle: An article presented in the form of a numbered or bulleted list.
  3. 3.  pillar: A comprehensive guide on a particular topic that covers all its aspects.
  4. 4.  comparison: An article that contrasts two or more things.
  5. 5.  product_review: An evaluation of a particular product.
  6. 6.  product_alternative: Discussing alternative options to a particular product.
  7. 7.  product_use_case: An article detailing specific use cases or scenarios for a product.
moderequired
Default: "serp"
string

This field is used to decide the mode of the generation.

Modes are as follows:

  1. 1.  serp
  2. 2.  instruct
  3. 3.  domain
domain_list
array

This field is used to input the array of the domains you want to provide as a reference, while generating the content. This field needs to be passed if mode is “domain”.

Example: ["wikipedia.org", "medium.com"]

formalityrequired
Default: "casual"
string

This field is used to input formality to your generated content.

Available formality are:

  1. 1.  casual: A relaxed and informal tone.
  2. 2.  neutral: Balanced without expressing any strong feelings or bias.
  3. 3.  formal: Professional and follows strict conventions of grammar.
tonerequired
Default: "witty"
string

This field is used to input tone to your generated content.

Available tone are:

  1. 1.  personable: Helps you relate to your users on a personal level.
  2. 2.  confident: Assures users with a tone of certainty.
  3. 3.  empathetic: Understand and express the feelings of users.
  4. 4.  engaging: Keeps users interested and invested.
  5. 5.  witty: Adds humor to make users smile.
  6. 6.  direct: Gets straight to the point for users who prefer clarity.

Response

status
string

Indicates whether the call was successful. It prompts success if working, otherwise not.

copies
object

The generated content.

message
string

This information is attached to the call and offers meaningful details when errors occur.

credits_used
number

This field informs you about the credits consumed for this particular request. It varies on the generated content.

curl --location --request POST 'https://api-hetz.longshot.ai/custom/api/generate/one/click/blog'             
--header 'Content-Type: application/json'             
--header 'Authorization: Bearer <token>'            
--data-raw '{
    "topic": "",
    "description": "",
    "blog_type": "listicle",
    "mode": "serp",
    "domain_list": [],
    "formality": "casual",
    "tone":"witty"
}'
{
  "copies": [
    {
      "content": "<Generated Blog>"
    }
  ],
  "status": "success",
  "message": "Generated successfully",
  "credits_used": "<Credits>"
}