Get Article
curl --request POST \
--url https://api.byword.ai/get_article \
--header 'Content-Type: application/json' \
--data '
{
"key": "<string>",
"articleID": "<string>"
}
'import requests
url = "https://api.byword.ai/get_article"
payload = {
"key": "<string>",
"articleID": "<string>"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({key: '<string>', articleID: '<string>'})
};
fetch('https://api.byword.ai/get_article', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.byword.ai/get_article",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'key' => '<string>',
'articleID' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.byword.ai/get_article"
payload := strings.NewReader("{\n \"key\": \"<string>\",\n \"articleID\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.byword.ai/get_article")
.header("Content-Type", "application/json")
.body("{\n \"key\": \"<string>\",\n \"articleID\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.byword.ai/get_article")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"key\": \"<string>\",\n \"articleID\": \"<string>\"\n}"
response = http.request(request)
puts response.read_bodyAPI
Get Article
Retrieve articles created via the Create Article endpoint
POST
/
get_article
Get Article
curl --request POST \
--url https://api.byword.ai/get_article \
--header 'Content-Type: application/json' \
--data '
{
"key": "<string>",
"articleID": "<string>"
}
'import requests
url = "https://api.byword.ai/get_article"
payload = {
"key": "<string>",
"articleID": "<string>"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({key: '<string>', articleID: '<string>'})
};
fetch('https://api.byword.ai/get_article', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.byword.ai/get_article",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'key' => '<string>',
'articleID' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.byword.ai/get_article"
payload := strings.NewReader("{\n \"key\": \"<string>\",\n \"articleID\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.byword.ai/get_article")
.header("Content-Type", "application/json")
.body("{\n \"key\": \"<string>\",\n \"articleID\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.byword.ai/get_article")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"key\": \"<string>\",\n \"articleID\": \"<string>\"\n}"
response = http.request(request)
puts response.read_bodyThis endpoint allows you to retrieve articles created via Create Article. Articles typically take around 60 seconds to generate, so it’s recommended to call this API at 5 second intervals until the endpoint returns a response with all of the article’s fields.
Request
string
required
The ID of the article that was returned from the Create Article endpoint.
Response
The response will contain all of the article’s fields when ready. While the article is still generating, you may receive a partial response.Examples
Request Example
{
"key": "your_api_key_here",
"articleID": "1234567890abcdef"
}
Success Response
{
"status": "complete",
"title": "Sample Article Title",
"content": "The full article content...",
"wordCount": 1500,
"language": "English",
"createdAt": "2025-03-25T12:34:56Z"
}
Processing Response
{
"status": "processing",
"message": "Your article is still being generated. Please try again in a few seconds."
}
Implementation Notes
- Articles typically take around 60-120 seconds to generate, but this can vary based on length and complexity.
- It’s recommended to poll this endpoint at 5-second intervals until you receive a complete response.
- Consider implementing an exponential backoff strategy for production applications.
Was this page helpful?