API Documentation
1.Validate Token
API to validate token, pass api token to check if it configured properly.
Authorization
Each request should send Authorization token as Bearer token, this token can be generated from dashboard.
2. Informative Article Generation
Generates informative article focused on SEO and user intent satisfaction
Parameter | Required | Type | Description |
---|---|---|---|
title | Required | String | The title of the article. Required if keyword is not present. |
keyword | Required | String | The keyword or topic of the article. Required if title is not present. |
language | Optional | String | Default is English ("en"): The language in which the article should be written. |
country | Optional | String | Default is United States ("US"): The specific country context for the article. |
focus | Optional | String | Additional focus or context for the article. |
add_internal_links | Optional | Boolean | Default is false: Whether to add internal links to the article. |
project_website | Conditional | String | The website URL for internal linking. **Required if add_internal_links is true. |
add_external_links | Optional | Boolean | Default is false: Whether to add external links to the article. |
* Important: At least either the title or the keyword must be provided.
* Bulk Creation: API allow generating one content in one API call, so you can send multiple calls to generate multiple content at same time.
3. Get My Contents
Fetch list of contents, you have added to generate, below are the list of query parameters to filter data
Parameter | Required | Type | Description |
---|---|---|---|
page | Optional | Number | Page to fetch |
limit | Optional | Number | No of items per page. |
search | Required | String | Search title field, like title/keyword for article or Content ID |
status | Optional | String | To filter data with status. Statuses are: creating/failed/completed |
type | Optional | String | To filter data with type. Type is: article |
4. Content Details
Fetch details of single content, below is the details how to replace {contentId} in url
Parameter | Required | Type | Description |
---|---|---|---|
contentId | Required | String | Id of content required in my content api, it should be passed in url like url param |
5. Credit Consumption
To use Vuela's API, you must have credits in your account. Our credit system ensures fair usage and helps maintain the quality of our services.
Please note: In the event of an API error or if Vuela is unable to generate content, no credits will be charged to your account. We only deduct credits for successful operations that deliver content.