# Webhooks

A webhook turns every article you publish in Junia AI into an HTTP request to an address you choose. Whatever sits at that address (your own site, a headless CMS, or a Zapier, Make or n8n workflow) receives the finished article as JSON and decides what to do with it.

## At a glance

1. You publish an article to your webhook, by hand, on a schedule, or from an [Autoblog campaign](/docs/how-to-create-an-autoblog-campaign).
2. Junia sends a `POST` request with the article as JSON.
3. Your endpoint checks that the request came from Junia, saves the article and replies with a `2xx` status.
4. If you publish the same article again later, it arrives with `is_update: true` so you can update it instead of creating a copy.

## The no-code route: Zapier, Make or n8n

You don't need to write any code to use webhooks.

1. In your automation tool, start a new workflow with a **webhook trigger** (in Zapier it's called *Catch Hook*) and copy the URL it gives you.
2. In Junia, open **Integrations → Publish via Webhook → Connect**.
3. Paste the URL and set **Security** to **Shared token**.
4. Click **Send Test**. Your automation tool now knows every field Junia sends, so you can map `title`, `content_html` and the rest into the next step.
5. Click **Save Webhook**.

## Building your own endpoint

### Step 1: add the webhook in Junia

Open **Integrations → Publish via Webhook → Connect** and fill in:

| Setting | What to enter |
| --- | --- |
| Integration Name | Anything that helps you recognise it, e.g. "Production blog". |
| Webhook URL | A public `http(s)` address that accepts `POST` requests. Local and private network addresses are rejected. |
| Security | **Signed requests** (recommended) or **Shared token**, see Step 2. |
| Secret Key | Generated for you. Copy it into your server's configuration, e.g. an environment variable called `JUNIA_WEBHOOK_SECRET`. You can regenerate it at any time. |

### Step 2: check that requests really come from Junia

Your endpoint is public, so it should ignore requests that don't carry your secret.

| | Signed requests | Shared token |
| --- | --- | --- |
| Header | `X-Junia-Signature` | `Authorization: Bearer <secret>` |
| What your endpoint does | Recalculates an HMAC SHA-256 of the request body with your secret and compares | Compares the header with your secret |
| The secret travels with the request | No | Yes |
| Also proves the body wasn't changed | Yes | No |
| Best for | Your own code | No-code tools |

Every request also carries `Content-Type: application/json`, `User-Agent: Junia-Webhooks/1.0` and a unique `X-Junia-Delivery` id you can log.

**About signed requests:** the signature covers the exact bytes Junia sent, so calculate it from the unparsed request body. Parsing the JSON and turning it back into a string can change spacing or escaping, and the signature would no longer match. The examples below read the raw body first and then parse it.

#### Next.js (App Router)

```js
// app/api/junia/route.js
import crypto from "crypto";

export async function POST(req) {
  const body = await req.text();
  const signature = crypto
    .createHmac("sha256", process.env.JUNIA_WEBHOOK_SECRET)
    .update(body)
    .digest("hex");

  if (req.headers.get("x-junia-signature") !== signature) {
    return new Response("Forbidden", { status: 403 });
  }

  const article = JSON.parse(body);
  if (!article.test) {
    await saveArticle(article); // see "Keeping articles in sync"
  }
  return Response.json({ ok: true });
}
```

#### Express

```js
import crypto from "crypto";
import express from "express";

const app = express();

// Keep the raw bytes for the signature check; req.body is still parsed JSON.
app.use(express.json({ verify: (req, res, buf) => (req.rawBody = buf) }));

app.post("/junia", async (req, res) => {
  const signature = crypto
    .createHmac("sha256", process.env.JUNIA_WEBHOOK_SECRET)
    .update(req.rawBody)
    .digest("hex");

  if (req.get("x-junia-signature") !== signature) {
    return res.sendStatus(403);
  }

  if (!req.body.test) {
    await saveArticle(req.body);
  }
  res.json({ ok: true });
});
```

For a constant-time comparison, use `crypto.timingSafeEqual` instead of `!==`.

#### PHP

```php
<?php
$body = file_get_contents('php://input');
$signature = hash_hmac('sha256', $body, getenv('JUNIA_WEBHOOK_SECRET'));

if (!hash_equals($signature, $_SERVER['HTTP_X_JUNIA_SIGNATURE'] ?? '')) {
    http_response_code(403);
    exit;
}

$article = json_decode($body, true);
if (empty($article['test'])) {
    save_article($article);
}

header('Content-Type: application/json');
echo json_encode(['ok' => true]);
```

#### Using a shared token instead

Replace the signature check with a header comparison. Your framework's parsed body can be used directly.

```js
if (req.headers.authorization !== `Bearer ${process.env.JUNIA_WEBHOOK_SECRET}`) {
  return res.sendStatus(403);
}
```

```php
if (!hash_equals('Bearer ' . getenv('JUNIA_WEBHOOK_SECRET'), $_SERVER['HTTP_AUTHORIZATION'] ?? '')) {
    http_response_code(403);
    exit;
}
```

### Step 3: send a test

Before (or after) saving, click **Send Test** in the webhook settings. Junia posts a sample article with `"test": true` and shows you the status code, the response time and whatever your endpoint replied. Skip saving when `test` is `true`, as in the examples above.

### Step 4: save and publish

Click **Save Webhook**. Your webhook now appears everywhere you can publish: the **Publish** menu in the editor, bulk generation and Autoblog campaigns.

## Keeping articles in sync

Every article keeps the same `id` and `slug` for as long as it is sent to the same webhook. That lets you treat each delivery as "here is the latest version of this article" rather than "here is a new article".

**When you'll receive an update**

- You edit an article in Junia, open **Publish → Webhook** and click **Update Article**.
- An article that was already delivered is published to the same webhook again, e.g. from a schedule.

Updates arrive with `"is_update": true`. The title, content, images and meta fields reflect your latest edits, and `published_url` contains the URL your endpoint returned the first time (see "Responding to Junia").

**How to store articles**

1. Keep Junia's `id` next to each article you save (for example in a `junia_id` column with a unique index).
2. On every delivery, look the article up by `id`. Update it if it exists, create it if not.
3. Use `is_update` for logging or notifications, not to decide whether to insert. That way a missed or repeated delivery can never create a duplicate.

In SQL, that's a single statement:

```sql
INSERT INTO articles (junia_id, slug, title, body_html, updated_at)
VALUES ($1, $2, $3, $4, now())
ON CONFLICT (junia_id) DO UPDATE
SET title = EXCLUDED.title,
    body_html = EXCLUDED.body_html,
    updated_at = now();
```

The slug is deliberately left out of the update. It never changes after the first delivery, so links to the article keep working even if you rename it.

## Payload reference

```json
{
  "id": "5f0c1c2e-8a4b-4d57-9b8e-2f1d7c3a9e10",
  "title": "10 Ways to Repurpose a Blog Post",
  "content_html": "<p>One good article can become a week of content...</p><h2>1. Turn it into a newsletter</h2>...",
  "content_markdown": "One good article can become a week of content...\n\n## 1. Turn it into a newsletter\n...",
  "slug": "10-ways-to-repurpose-a-blog-post",
  "meta_title": "10 Ways to Repurpose a Blog Post (2026 Guide)",
  "meta_description": "Get more from every article with these ten repurposing ideas.",
  "status": "published",
  "featured_image": "https://example.com/images/repurpose.png",
  "featured_image_alt": "Blog post turned into social media posts",
  "published_url": null,
  "scheduled_date": null,
  "published_at": "2026-09-23T10:30:00.000Z",
  "is_update": false,
  "test": false,
  "language": "English",
  "tags": ["content marketing", "repurposing"],
  "faqs": [
    { "question": "How often should I repurpose content?", "answer": "Whenever an article is still getting traffic." }
  ]
}
```

| Field | Type | Notes |
| --- | --- | --- |
| `id` | string | Junia's article id. Never changes, use it as your key. |
| `title` | string | The article's H1. |
| `content_html` | string | Body as HTML, without the title and featured image (they have their own fields). Other images are included with their URLs. |
| `content_markdown` | string | The same body as Markdown. |
| `slug` | string | URL slug. Fixed after the first delivery to this webhook. |
| `meta_title`, `meta_description` | string | SEO metadata. |
| `status` | string | `published`, or `draft` if you picked Draft when publishing. |
| `featured_image`, `featured_image_alt` | string or null | Featured image URL and its alt text. |
| `published_url` | string or null | The article's public URL, if your endpoint returned one on an earlier delivery. |
| `scheduled_date` | string or null | The date you scheduled the article for, if any. |
| `published_at` | string | When this request was sent (ISO 8601). Rejecting old values protects against replayed requests. |
| `is_update` | boolean | `true` if this article was delivered to this webhook before. |
| `test` | boolean | `true` only for **Send Test** requests. |
| `language` | string | Article language, e.g. `English`. |
| `tags` | string[] | Tags on the article. |
| `faqs` | object[] | `{ question, answer }` pairs. |

## Responding to Junia

- Reply with any `2xx` status within **30 seconds** to confirm delivery. Anything else counts as a failure.
- Redirects are not followed, so point the webhook at the final URL.
- Optionally include the article's public address in a JSON response: `{ "url": "https://example.com/blog/10-ways-to-repurpose-a-blog-post" }`. Junia opens it after publishing, can submit it to search engines for indexing, and sends it back as `published_url` in later updates.

## When something goes wrong

| What you see | Likely cause | What to do |
| --- | --- | --- |
| Your endpoint returns 401 or 403 | The secret or security type doesn't match | Copy the Secret Key again and check the Security setting matches your code. With signed requests, make sure you sign the raw body. |
| 403 before your code even runs | A firewall, bot protection or security plugin blocked the request | Allow `POST` requests with the user agent `Junia-Webhooks/1.0` to your webhook path. |
| "Webhook URL must be publicly accessible" | The URL points to `localhost` or a private network | Deploy your endpoint, or expose it with a tunnel such as ngrok while developing. |
| Status 3xx | Your URL redirects, e.g. `http` to `https` or a missing trailing slash | Use the final URL. |
| "No response within 30 seconds" | Your endpoint does slow work before replying | Reply first, then process the article in the background. |
| Duplicate articles on your site | Saving by title or creating a new row on every request | Upsert on `id`, see "Keeping articles in sync". |

When a scheduled or Autoblog delivery fails, Junia emails you so you can publish the article again.

## Questions

**Can one article go to several webhooks?**
Yes. Add as many webhooks as you like and publish to each one. Updates are tracked separately per webhook.

**Can I send drafts?**
Yes. Choose **Draft** when publishing and the payload arrives with `"status": "draft"`. It's up to your endpoint to keep it unpublished.

**Is my content encrypted?**
Use an `https://` URL and the request is encrypted in transit. Signed requests also make sure nobody changed the content along the way.

**What if I regenerate the secret?**
Requests are signed with the new secret straight away, so update your server's configuration at the same time.

**Does the payload include images?**
Yes. The featured image has its own fields, and every other image stays in `content_html` (and `content_markdown`) with its original URL.

Deliver every published article to your own endpoint or an automation tool.

Receive every Junia AI article as JSON on your own server, headless CMS, Zapier, Make or n8n. Security options, payload reference and update handling.

Webhooks: Deliver Junia AI Articles Anywhere | Junia AI Help Centre

Webhooks

# Connect Wix to Junia AI

Use Wix so [Autoblog](/docs/how-to-create-an-autoblog-campaign) can publish to your blog, or publish one article from the editor.

## Before you start

You’ll need:

- your **Wix Site ID**
- a **Wix API key** with Wix Blog permissions

Once connected, you can publish posts to Wix without copying content manually.

## Step 1, find your Wix Site ID

1. Log in to your Wix account.
2. Open the site you want to connect.
3. Look at the URL in your browser.
4. Copy the site identifier shown in the Wix dashboard URL.
5. For example, copy the value after `metaSiteId` in the screenshot below.

![](https://api.junia.ai/storage/v1/object/public/public/Screenshot%202026-04-13%20at%2020.50.01.png)

## Step 2, create a Wix API key

1. In Wix, open **Account Settings**.
2. Scroll down and open **API Keys**.
3. Create a new API key.
4. Give it a clear name, for example `Junia Wix Integration`.
5. Enable the permissions needed for **Wix Blog**.
6. Complete email verification if Wix prompts you.
7. Copy the generated API key.

## Step 3, connect Wix inside Junia

1. In Junia, go to **Integrations**.
2. Click **Wix**.
3. Enter your **Site ID**.
4. Paste your **API key**.
5. Save the integration.

After saving, Junia will use this connection when publishing to your Wix blog.

## Publishing to Wix

After your integration is connected, you can publish articles from Junia to Wix.

Depending on your setup, you can:

- publish immediately
- save as draft first
- choose the Wix member used for publishing
- select categories and tags before publishing

## Troubleshooting

### Invalid credentials

Double-check that:

- the Site ID matches the correct Wix site
- the API key was copied fully
- the API key includes Wix Blog permissions

### No Wix members available

If publishing requires a Wix member, make sure your Wix site has at least one valid member account available.

## Tips

- Use a dedicated API key for Junia so it is easier to manage later.
- Test with a draft post first before publishing live.
- If you manage multiple Wix sites, create one integration per site.

## Need help?

If the connection fails, reconnect the integration and verify your Wix Site ID and API key again.

Easily connect Junia AI to your Wix blog and publish articles instantly with our step-by-step integration guide.

How to Connect Junia AI to Wix: Easy Integration Guide

Connect To Wix Blog

# Connect to Self-hosted WordPress Site With Username and Application Password

Connect WordPress so [Autoblog](/docs/how-to-create-an-autoblog-campaign) can publish for you. You can connect more than one site.

**Note**:

1. If you use Namecheap to host your WordPress, scroll down to the **Troubleshooting** section as Namecheap uses a user-level password instead of an application password.
2. Even if you think you entered the correct username and password, check again. This accounts for 99.9% of failed connections. Remember that your username is probably not your email. Double-check for case sensitivity, special characters, and spaces.
3. Your username is the one you use to log in to your WordPress site, not the "Application Password Name".

You could find your WordPress Application Password with the following steps:

1. Access your WordPress Profile Page.

![Navigate to wordpress profile page](https://api.junia.ai/storage/v1/object/sign/user-generated-images/f2f98d5e-63c4-412b-92cd-f82429517add/Screenshot%202024-02-07%20at%200.42.14.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJ1c2VyLWdlbmVyYXRlZC1pbWFnZXMvZjJmOThkNWUtNjNjNC00MTJiLTkyY2QtZjgyNDI5NTE3YWRkL1NjcmVlbnNob3QgMjAyNC0wMi0wNyBhdCAwLjQyLjE0LnBuZyIsImlhdCI6MTcwNzI1OTM0MiwiZXhwIjoyMDIyNjE5MzQyfQ.Ye5NyHqXofRahkx11-0i2_SScGQXz7kWdc9tH7kX5q8)

2. Scroll down to find the Application Passwords and generate an application password.

![Generate WordPress Application Passwords](https://api.junia.ai/storage/v1/object/sign/user-generated-images/f2f98d5e-63c4-412b-92cd-f82429517add/Screenshot%202024-02-07%20at%200.43.39.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJ1c2VyLWdlbmVyYXRlZC1pbWFnZXMvZjJmOThkNWUtNjNjNC00MTJiLTkyY2QtZjgyNDI5NTE3YWRkL1NjcmVlbnNob3QgMjAyNC0wMi0wNyBhdCAwLjQzLjM5LnBuZyIsImlhdCI6MTcwNzI1OTQyNiwiZXhwIjoyMDIyNjE5NDI2fQ.U63C1Z7oIvPI67BPeQs0BUMH2Ts6DjiMx9FhTMoTKCE)

3. To complete the integration, return to Junia's integration interface at https://www.junia.ai/dashboard/integrations. Look for the WordPress option, input your WordPress credentials and click on "connect." Follow the rest of the instructions provided.

![Connect Junia.ai to WordPress](https://api.junia.ai/storage/v1/object/sign/user-generated-images/f2f98d5e-63c4-412b-92cd-f82429517add/Screenshot%202024-02-07%20at%200.45.19.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJ1c2VyLWdlbmVyYXRlZC1pbWFnZXMvZjJmOThkNWUtNjNjNC00MTJiLTkyY2QtZjgyNDI5NTE3YWRkL1NjcmVlbnNob3QgMjAyNC0wMi0wNyBhdCAwLjQ1LjE5LnBuZyIsImlhdCI6MTcwNzI1OTUyNiwiZXhwIjoyMDIyNjE5NTI2fQ.UtEtlOHLsRmLZLZdEPqwyLrEruAUgVVZAq4k6ju1N3c)

## Troubleshooting

If you encounter errors concerning your WordPress connection, they are due to one of the following three reasons, **which account for 100% of the cases we've observed from our users**:

#### 1. Typo In Username Or PassWord

This accounts for __99.9% of the cases__ why the connection failed. When users claim that their username/password is correct and have given us access to their WordPress, we have discovered that the username/password is often incorrect. For example, it may be due to incorrect casing or a missing character.

#### 2. Incorrect WordPress URL

When entering your WordPress URL, make sure to input the accurate full address. For instance, if the URL of your WordPress site is `https://www.junia.ai`, you should enter it just like that, `https://www.junia.ai`. Do not add any additional paths or parameters to the end of the URL such as `https://www.junia.ai/admin.php`. It should not be `junia.ai` either but rather the full URL. The exact URL is critical for successful integration and connectivity.

#### 3. Your Web Hosting Doesn't Support Application Passwords

It's also likely that there's an issue with the application password because your web hosting platform may not have adequate support. We recommend generating a user-level password and using it as the Application Password.

You can find the interface for generating a user-level password on the same profile page by scrolling down to the "Account Management" section and clicking on "Set New Password":

![Set New Password](https://api.junia.ai/storage/v1/object/sign/user-generated-images/f2f98d5e-63c4-412b-92cd-f82429517add/Screenshot%202024-02-07%20at%200.48.54.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJ1c2VyLWdlbmVyYXRlZC1pbWFnZXMvZjJmOThkNWUtNjNjNC00MTJiLTkyY2QtZjgyNDI5NTE3YWRkL1NjcmVlbnNob3QgMjAyNC0wMi0wNyBhdCAwLjQ4LjU0LnBuZyIsImlhdCI6MTcwNzI1OTc0MSwiZXhwIjoyMDIyNjE5NzQxfQ.XnYKjdoNZ17hm1w9stzEhr8_5Oi_9qo5iJG2gpDVaQ8)

**Note**: Remember to click on the "Update User" button after generating the Password.

#### 4. Your WordPress Account Doesn't Have the Proper Access Right

If you have recently made any changes to your WordPress user roles or permissions, it is possible that your profile may not have the necessary access rights to connect with external applications. To rectify this, you can navigate to the "Users" section in your WordPress dashboard and ensure that your profile has the appropriate role and capabilities assigned to it. If needed, you can edit your profile or contact your website administrator for assistance in granting the required access rights.

#### 5. Security Plugins

There might be some security plugins or firewall settings on your website that are blocking the connection between WordPress and the external application. To troubleshoot this, you can temporarily deactivate any security plugins or modify their settings to allow the connection.

#### 6. Change Permalink Structure

Click on "Settings" in the left sidebar, click on "Permalinks," locate the "Permalink Structure" section, and choose any option other than "Plain.

**It's almost impossible for the connection to fail after trying all the above solutions**, as we haven't seen any other cases otherwise so far. **The number one reason is still wrong username and password**, even if you think you typed in the correct information. Double-check your input and make sure there are no spelling mistakes or extra spaces and make sure the username you enter is the one you use to log in to your WordPress account.

Connect to Self-hosted WordPress Site With Username and Application Password

Learn how to connect to Self-hosted WordPress Site with username and password from Junia AI

Connect to Self-hosted WordPress Site with username and password from Junia AI

# Junia AI API

Use the API when you want Autoblog or the editor to publish into your own app instead of WordPress or Shopify. You can fetch published articles and display them on your site.

__Note: We recommend not to use Postman to test the API integration as it is an unreliable tool.__

## Publish Your Articles

To make your articles available to the Junia API, you need to publish them either:

1.  Via the bulk generator to have the articles published automatically to our API once the articles are generated.
2.  Or you can publish them using the publishing option in the Junia AI Editor. Please see the screenshot below:

![Publish To Junia AI API](https://api.junia.ai/storage/v1/object/sign/user-generated-images/f2f98d5e-63c4-412b-92cd-f82429517add/Screenshot%202024-09-24%20at%2022.35.38.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJ1c2VyLWdlbmVyYXRlZC1pbWFnZXMvZjJmOThkNWUtNjNjNC00MTJiLTkyY2QtZjgyNDI5NTE3YWRkL1NjcmVlbnNob3QgMjAyNC0wOS0yNCBhdCAyMi4zNS4zOC5wbmciLCJpYXQiOjE3MjcyMDY1NDgsImV4cCI6MjA0MjU2NjU0OH0.FYC6lGHOmz2hJMnnAVe0ZvFCER7qT6ePiQ51Bei-hvA)

__Remember to republish your article to the Junia AI API every time you make an edit to ensure that the latest version is available through the API.__

## Authentication

To use the Junia AI API, you'll need to obtain an API key. You can generate an API key by navigating to the "API Key" section in your Junia dashboard settings at <https://www.junia.ai/dashboard/settings>.

Once you have your API key, you'll need to include it in the `x-api-key` header for all your API requests.

## Fetching All Published Articles

To retrieve a list of all published articles, make a `POST` request to the following endpoint:

__https://api-v1.junia.ai/api/public/collections__

You can include the following optional parameters in the request body:

*   `excludeSlugs` (string): A comma-separated list of article slugs that you want to exclude from the response.
*   `includeSlugs` (string): A comma-separated list of article slugs that you want to include in the response.
*   `includeContent` (boolean): If set to `true`, the response will include the HTML content of each article. Setting this to `false` (the default) can improve performance by only returning the article metadata.
*  `offset` (number): The number of articles to skip before starting to return results. Default is 0.
* `limit` (number): The maximum number of articles to return. Default is 30.

#### Pagination

The API uses offset-based pagination. By default, it will return 30 articles per request. You can use the `offset` and `limit` parameters to control the pagination:

- Use `offset` to skip a certain number of articles (e.g., set `offset: 30` to get the second page of results when using the default limit).
- Use `limit` to specify how many articles you want to receive per request.

#### Here's an example request (general):

POST **https://api-v1.junia.ai/api/public/collections**

**Headers**

    x-api-key: your-api-key

**Post Body**

    {
    "excludeSlugs": "article-to-exclude-1, article-to-exclude-2",
    "includeSlugs": "article-to-include-1, article-to-include-2",
    "includeContent": false,
    "offset": 0,
    "limit": 40
    }

#### Example Request (Node.js)

    const fetch = require('node-fetch');
    const apiKey = 'your-api-key';
    const requestBody = {
     excludeSlugs: 'article-to-exclude-1, article-to-exclude-2',
     includeSlugs: 'article-to-include-1, article-to-include-2',
     includeContent: false,
     "offset": 0,
     "limit": 40
    };
    fetch('https://api-v1.junia.ai/api/public/collections', {
     method: 'POST',
     headers: {
     'x-api-key': apiKey
     },
     body: JSON.stringify(requestBody)
    })
     .then(response => response.json())

##### Example Request (PHP)

    <?php
    $apiKey = 'your-api-key';
    $requestBody = [
     'excludeSlugs' => 'article-to-exclude-1, article-to-exclude-2',
     'includeSlugs' => 'article-to-include-1, article-to-include-2',
     'includeContent' => false
    ];

    $ch = curl_init('https://api-v1.junia.ai/api/public/collections');
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($requestBody));
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
     'x-api-key: ' . $apiKey
    ]);

    $response = curl_exec($ch);
    $data = json_decode($response, true);
    curl_close($ch);

    print_r($data);
    ?>

#### Example Response

    {
     "data": [
     {
     "slug": "article-slug-1",
     "title": "Article Title 1",
     "language": "English",
     "metaTitle": "Article Meta Title 1",
     "updatedAt": "2023-08-15T12:34:56Z",
     "publishedAt": "2023-08-01T12:34:56Z",
     "createdAt": "2023-07-25T12:34:56Z",
     "featureImage": "https://example.com/article-image-1.jpg",
     "featureImageAlt": "Article 1 Feature Image",
     "metaDescription": "Article 1 meta description",
     "preview": "This is a preview of article 1",
     "content": "This is the HTML content of article 1.", 
     "markdown": "The content in marakdown format",
     "faq": 
       [{
         "question": "FAQ Question 1",
          "answer": "FAQ Answer 1"
       }]
    }
    ],
    hasMore: true
    }

## Fetching a Single Article

To retrieve a single published article, make a `POST` request to the following endpoint:

https://api-v1.junia.ai/api/public/collection

Include the following parameter in the request body:

*   `slug` (string): The slug of the article you want to retrieve.

#### Here's an example request (general):

POST **https://api-v1.junia.ai/api/public/collection**

**Headers**

    x-api-key: your-api-key

**Post Body**

    { 
      "slug": "my-article-slug" 
    }

#### Example Request (Node.js)

    const fetch = require('node-fetch');

    const apiKey = 'your-api-key';
    const requestBody = {
     slug: 'my-article-slug'
    };

    fetch('https://api-v1.junia.ai/api/public/collection', {
     method: 'POST',
     headers: {
     'x-api-key': apiKey,
     },
     body: JSON.stringify(requestBody)
    })
     .then(response => response.json())
     .then(data => console.log(data))
     .catch(error => console.error(error));

#### Example Request (PHP)

    <?php
    $apiKey = 'your-api-key';
    $requestBody = [
     'slug' => 'my-article-slug'
    ];

    $ch = curl_init('https://api-v1.junia.ai/api/public/collection');
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($requestBody));
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
     'x-api-key: ' . $apiKey
    ]);

    $response = curl_exec($ch);
    $data = json_decode($response, true);
    curl_close($ch);

    print_r($data);
    ?>

#### Example Response

    {
     "data": {
     "slug": "article-slug-1",
     "title": "Article Title 1",
     "language": "English",
     "metaTitle": "Article Meta Title 1",
     "updatedAt": "2023-08-15T12:34:56Z",
     "publishedAt": "2023-08-01T12:34:56Z",
     "createdAt": "2023-07-25T12:34:56Z",
     "featureImage": "https://example.com/article-image-1.jpg",
     "featureImageAlt": "Article 1 Feature Image",
     "metaDescription": "Article 1 meta description",
     "content": "This is the HTML content of article 1.", 
     "markdown": "The content in marakdown format",
     "faq": 
       [{
         "question": "FAQ Question 1",
         "answer": "FAQ Answer 1"
       }]
     }
    }

## Rate Limiting

Please note that the Junia AI API is rate-limited to prevent abuse. We recommend caching your articles as much as possible to avoid any issues.

Integrate with Junia AI API to fetch and publish articles effortlessly. Learn about authentication, requests, and rate limits.

Junia AI API: Access and Publish Articles Programmatically

Fetch Articles From Junia AI API

# Connect to Ghost Blog

![Connect to Ghost Blog](https://api.junia.ai/storage/v1/object/sign/user-generated-images/f2f98d5e-63c4-412b-92cd-f82429517add/Screenshot%202024-10-13%20at%2020.04.28.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJ1c2VyLWdlbmVyYXRlZC1pbWFnZXMvZjJmOThkNWUtNjNjNC00MTJiLTkyY2QtZjgyNDI5NTE3YWRkL1NjcmVlbnNob3QgMjAyNC0xMC0xMyBhdCAyMC4wNC4yOC5wbmciLCJpYXQiOjE3Mjg4MzkwNzUsImV4cCI6MjA0NDE5OTA3NX0.P8ZiQwDMveYyVdwGEo5OL6jmKoyfcFLtBb97Y9dhbbU)

Connect Ghost so [Autoblog](/docs/how-to-create-an-autoblog-campaign) can publish for you. You can connect more than one Ghost site.

1. Open Ghost **Settings**.
2. Open **Integrations**.
3. Click **Add custom integration**.
4. Copy the **Admin API key** and **API URL** into [Junia Integrations](/dashboard/integrations).

## Troubleshooting

If you encounter errors concerning your Ghost connection, they are due to one of the following three reasons:

#### 1. Incorrect Ghost URL

When entering your Ghost URL, make sure they are in the following format: https://your-ghost-blog-name.ghost.io

#### 2. Your Post Is Being Edited Somewhere Else

If publishing the post failed, it could mean your post is being edited in the ghost editor in a different tab or by a different user. Make sure you save the changes, close those tabs, and edit your post in Junia instead.

Learn how to connect to Ghost from Junia AI

Connect to Ghost from Junia AI

Connect To Ghost Blog

# Connect to Shopify

Connect Shopify so [Autoblog](/docs/how-to-create-an-autoblog-campaign) can publish to your store blog.

This process requires several steps:

#### Step 1

Navigate to the "Settings" of your Shopify store.

![Navigate to the "Settings" of your Shopify store.](https://api.junia.ai/storage/v1/object/sign/user-generated-images/f2f98d5e-63c4-412b-92cd-f82429517add/Group%20499.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJ1c2VyLWdlbmVyYXRlZC1pbWFnZXMvZjJmOThkNWUtNjNjNC00MTJiLTkyY2QtZjgyNDI5NTE3YWRkL0dyb3VwIDQ5OS5wbmciLCJpYXQiOjE3MDA0MjA3NTEsImV4cCI6MTg1ODEwMDc1MX0.GE6BUd5Ucoz11T7hXjYAPypjSY-n1MhDqJmHURn2Guc)

### Step 2

Select the "Apps and Sales Channels" tab, then click on "Develop Apps".

![Select the "Apps and Sales Channels" tab, then click on "Develop Apps".](https://api.junia.ai/storage/v1/object/sign/user-generated-images/f2f98d5e-63c4-412b-92cd-f82429517add/Group%20500.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJ1c2VyLWdlbmVyYXRlZC1pbWFnZXMvZjJmOThkNWUtNjNjNC00MTJiLTkyY2QtZjgyNDI5NTE3YWRkL0dyb3VwIDUwMC5wbmciLCJpYXQiOjE3MDA0MjA4OTksImV4cCI6MTg1ODEwMDg5OX0.fwSUDl2bS_1dqs1NUCAA5wN9zZgGjGOAhNNxyoLFN2g)

### Step 3

Click on "Create an App," and you can enter any name for your custom Shopify app.

![Click on "Create an App," and you can enter any name for your custom Shopify app.](https://api.junia.ai/storage/v1/object/sign/user-generated-images/f2f98d5e-63c4-412b-92cd-f82429517add/Group%20501.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJ1c2VyLWdlbmVyYXRlZC1pbWFnZXMvZjJmOThkNWUtNjNjNC00MTJiLTkyY2QtZjgyNDI5NTE3YWRkL0dyb3VwIDUwMS5wbmciLCJpYXQiOjE3MDA0MjEwMTAsImV4cCI6MTg1ODEwMTAxMH0.rVUCARN3D8M_sgH-I3k10bJBnLmxXmz43f4d3oavlqs)

### Step 4

After creating your app, click on "Configure Admin API Scopes".

![After creating your app, click on "Configure Admin API Scopes".](https://api.junia.ai/storage/v1/object/sign/user-generated-images/f2f98d5e-63c4-412b-92cd-f82429517add/Group%20502.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJ1c2VyLWdlbmVyYXRlZC1pbWFnZXMvZjJmOThkNWUtNjNjNC00MTJiLTkyY2QtZjgyNDI5NTE3YWRkL0dyb3VwIDUwMi5wbmciLCJpYXQiOjE3MDA0MjExMDgsImV4cCI6MTg1ODEwMTEwOH0.jt_TP0AcTU4CtEWU-VEzEA3WraL9D3NCcEocZTAJZ58)

### Step 5

Search for the term "blog", grant access to "write_content" and "read_content", and then save the settings.

![Search for the term "blog", grant access to "write_content" and "read_content", and then save the settings.](https://api.junia.ai/storage/v1/object/sign/user-generated-images/f2f98d5e-63c4-412b-92cd-f82429517add/Group%20503.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJ1c2VyLWdlbmVyYXRlZC1pbWFnZXMvZjJmOThkNWUtNjNjNC00MTJiLTkyY2QtZjgyNDI5NTE3YWRkL0dyb3VwIDUwMy5wbmciLCJpYXQiOjE3MDA0MjExNzksImV4cCI6MTg1ODEwMTE3OX0.rgC_wFNQBdeXSGmzjLNjS5ZGxTOQZkaYOTVxUhn8TJU)

### Step 6

Go to the API Credentials tab and install the application.

![](https://api.junia.ai/storage/v1/object/sign/user-generated-images/f2f98d5e-63c4-412b-92cd-f82429517add/Screenshot%202023-11-19%20at%2021.13%201.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJ1c2VyLWdlbmVyYXRlZC1pbWFnZXMvZjJmOThkNWUtNjNjNC00MTJiLTkyY2QtZjgyNDI5NTE3YWRkL1NjcmVlbnNob3QgMjAyMy0xMS0xOSBhdCAyMS4xMyAxLnBuZyIsImlhdCI6MTcwMDQyMTI2NywiZXhwIjoxODU4MTAxMjY3fQ.2qvUG4PJLBWf-fjVImLUSBHVJHotewoDWxKSEmhqSxA)

### Step 7

Copy the "Admin API access token" and "API secret key" into Junia AI, as shown in the screenshots below.

![Copy the "Admin API access token" and "API secret key"](https://api.junia.ai/storage/v1/object/sign/user-generated-images/f2f98d5e-63c4-412b-92cd-f82429517add/Group%20504.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJ1c2VyLWdlbmVyYXRlZC1pbWFnZXMvZjJmOThkNWUtNjNjNC00MTJiLTkyY2QtZjgyNDI5NTE3YWRkL0dyb3VwIDUwNC5wbmciLCJpYXQiOjE3MDA0MjEzNTgsImV4cCI6MTg1ODEwMTM1OH0.aUGsD87wbiX3GXeZ7_5s8sVwa7mls0Xu4gxN5XieTyA)

![Copy the "Admin API access token" and "API secret key" into Junia AI](https://api.junia.ai/storage/v1/object/sign/user-generated-images/f2f98d5e-63c4-412b-92cd-f82429517add/Screenshot%202023-11-19%20at%2021.17.54.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJ1c2VyLWdlbmVyYXRlZC1pbWFnZXMvZjJmOThkNWUtNjNjNC00MTJiLTkyY2QtZjgyNDI5NTE3YWRkL1NjcmVlbnNob3QgMjAyMy0xMS0xOSBhdCAyMS4xNy41NC5wbmciLCJpYXQiOjE3MDA0MjE0ODgsImV4cCI6MTg1ODEwMTQ4OH0.KVnn7vGtUY2Nsx99Uu3j5gJ0iU5mjL3jgYkkTX2KBac)

That's it, you are now connected to Shopify.

Rest assure, your credentials is stored encrypted and securely in Junia AI, so you don't have to worry about any unauthorized access.

Once you have connected to Shopify, you can easily publish your articles directly from Junia AI to your Shopify store with just a few clicks.

### Known Limitation

Shopify does not allow a way to modify the meta title and meta description of your article programmatically, so you will need to manually modify these fields within your Shopify store after publishing the article.

### Troubleshooting

If the integration doesn't work after entering the correct credentials, they are due to one of the following two reasons, __which account for 100% of the cases we've observed from our users__:

#### 1. Incorrect Shopify URL

Shopify URLs must contain "**myshopify**" within the address. This is a Shopify requirement, and it helps to identify your specific store within the platform.

For instance, if your store name is Junia and you're trying to enter the URL as "junia.ai", Shopify won't recognize this as a valid format. Instead, you should enter it as "junia.myshopify.com". This format tells Shopify that this store belongs to the 'myshopify' domain and therefore is a valid store.

So, always remember to include ".myshopify" in your Shopify URL for successful integration.

**Note**: In some rare cases, your store URL may not be what is displayed in your browser's address bar. If you continue to encounter issues with the connection and believe you have entered the correct store URL, __we recommend contacting Shopify support. Inform them that you need to know the URL of your Shopify store for custom app development purposes.__

#### 2. Duplicate Article Titles

An error may also occur if the title of the article you're trying to publish has already been published in your Shopify store. If you wish to publish an article that has already been published, ensure that you input the existing article's "id" during the publishing process.

#### 3. Your account is limited by Shopify

Sometimes, Shopify may impose certain limitations on accounts, especially for new accounts. You would need to double-check if you receive any messages from Shopify that you need to further verify your identity, etc. Alternatively, you can contact Shopify to get your account unblocked.

Learn how to connect to Shopify with Junia AI

Connect to Shopify

Connect To Shopify

# Include Meta Title and Meta Description For Wordpress

To have the Meta Title and Meta Description appear automatically in WordPress when published with Junia AI's [WordPress Integration](https://www.junia.ai/docs/connect-to-self-hosted-wordpress-site), you need to install and activate the following two plugins:

**1. REST API Meta Support**

![REST API Meta Support](https://api.junia.ai/storage/v1/object/sign/user-generated-images/f2f98d5e-63c4-412b-92cd-f82429517add/Screenshot%202024-02-18%20at%200.06.04.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJ1c2VyLWdlbmVyYXRlZC1pbWFnZXMvZjJmOThkNWUtNjNjNC00MTJiLTkyY2QtZjgyNDI5NTE3YWRkL1NjcmVlbnNob3QgMjAyNC0wMi0xOCBhdCAwLjA2LjA0LnBuZyIsImlhdCI6MTcwODIwNzU3NCwiZXhwIjoyMDIzNTY3NTc0fQ.HaqSRPyomOqZ6n3AHUWr97vrRvKqa97alxpeXmMYszY)

**2. Yoast SEO Or Rank Math SEO**

You can install either the Yoast SEO Or Rank Math SEO Plugin.

![Yoast SEO](https://api.junia.ai/storage/v1/object/sign/user-generated-images/f2f98d5e-63c4-412b-92cd-f82429517add/Screenshot%202024-02-18%20at%200.05.36.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJ1c2VyLWdlbmVyYXRlZC1pbWFnZXMvZjJmOThkNWUtNjNjNC00MTJiLTkyY2QtZjgyNDI5NTE3YWRkL1NjcmVlbnNob3QgMjAyNC0wMi0xOCBhdCAwLjA1LjM2LnBuZyIsImlhdCI6MTcwODIwNzU0MywiZXhwIjoyMDIzNTY3NTQzfQ.7qMWaQM5yK_PrbrIplaPVIz3mqR1LEPRO4PaIbS4dfo)

![Rank Math SEO Plugin](https://api.junia.ai/storage/v1/object/sign/user-generated-images/f2f98d5e-63c4-412b-92cd-f82429517add/Screenshot%202024-02-18%20at%200.28.03.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJ1c2VyLWdlbmVyYXRlZC1pbWFnZXMvZjJmOThkNWUtNjNjNC00MTJiLTkyY2QtZjgyNDI5NTE3YWRkL1NjcmVlbnNob3QgMjAyNC0wMi0xOCBhdCAwLjI4LjAzLnBuZyIsImlhdCI6MTcwODIwODg4OSwiZXhwIjoyMDIzNTY4ODg5fQ.rqZzJr0K54ABlJ4iCGW8MGmn1e7rqLHaL_0ykXM44Ns)

Include Meta Title and Meta Description For Wordpress

Learn How To Include Meta Title and Meta Description For Wordpress

# Connect to Webflow

Connect Webflow so [Autoblog](/docs/how-to-create-an-autoblog-campaign) can publish to your CMS.

1. Open the [Webflow dashboard](https://webflow.com/dashboard) and go to **Settings** for that site.
2. Open **Apps & Integrations**.
3. Generate an API key with **CMS Read/Write** and **Sites Read**.
4. Paste the key into [Junia Integrations](/dashboard/integrations).

## Need help?

Email [support@junia.ai](mailto:support@junia.ai).

Learn how to connect to Webflow with Junia AI

Connect to Webflow

Connect To Webflow

# Connect to Medium

![AI Integration for Medium](https://api.junia.ai/storage/v1/object/sign/user-generated-images/f2f98d5e-63c4-412b-92cd-f82429517add/Screenshot%202024-01-24%20at%2016.21.45.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJ1c2VyLWdlbmVyYXRlZC1pbWFnZXMvZjJmOThkNWUtNjNjNC00MTJiLTkyY2QtZjgyNDI5NTE3YWRkL1NjcmVlbnNob3QgMjAyNC0wMS0yNCBhdCAxNi4yMS40NS5wbmciLCJpYXQiOjE3MDYxMDYxMTQsImV4cCI6MjAyMTQ2NjExNH0.WxqF4ayd6_FxSwfOtVRDUvwl3ShOpE--Om4vuwPwufM)

Connect Medium so [Autoblog](/docs/how-to-create-an-autoblog-campaign) can publish for you. You can connect more than one Medium account and pick which one to use.

Add the integration in [Junia Integrations](/dashboard/integrations), then choose it when you publish or launch Autoblog.

## Need help?

Email [support@junia.ai](mailto:support@junia.ai).

Learn how to connect Junia AI to your Medium accounts.

Connect To Medium

# Import content into Junia

![Import Content Functionality](https://api.junia.ai/storage/v1/object/public/public/Group%20266.png)

Import an existing page into the editor if you want to improve it, then publish it again or add it to Autoblog later.

## Importing HTML

![Importing HTML](https://api.junia.ai/storage/v1/object/public/public/Screenshot%202023-07-02%20at%2021.34%201.png)

Junia AI offers two ways to import HTML content: either paste the HTML directly or upload an HTML file.

### Pasting HTML Directly

1.  Copy all your HTML (Ctrl+C / Cmd+C).
2.  In our AI Editor, paste your copied content (Ctrl+V / Cmd+V).

### Uploading an HTML File

1.  In our AI Editor, click on the 'Import' button on the left-hand side and choose 'HTML'.
2.  Navigate to the location of your HTML file on your computer.
3.  Select the HTML file and click 'Open'. The content will be automatically imported into Junia AI.

Both methods will import your HTML content into Junia AI, ready for you to use with its advanced AI-powered features.

## Importing Markdown

![Importing Markdown](https://api.junia.ai/storage/v1/object/public/public/Screenshot%202023-07-02%20at%2022.16%201.png)

Junia AI provides two convenient ways to import Markdown content: pasting the Markdown directly or uploading a Markdown file.

### Pasting Markdown Directly

1.  Copy all your Markdown text (Ctrl+C / Cmd+C).
2.  In our AI Editor, paste your copied content (Ctrl+V / Cmd+V).

### Uploading a Markdown File

1.  In our AI Editor, click on the 'Import' button on the left-hand side and choose 'Text & Markdown'.
2.  Navigate to the location of your Markdown file on your computer.
3.  Select the Markdown file and click 'Open'. The content will be automatically imported into Junia AI.

## Importing from Google Docs

1.  Open your Google Doc.
2.  Click on 'File > Download > Microsoft Word (.docx)'.
3.  In our AI Editor, click on the 'Import' button on the left-hand side and choose 'Upload Docx'.
4.  Select "Google Docs" option and select your .docx file. The content from the Word document will be imported into Junia AI.

## Importing from WordPress

1.  In our AI Editor, click on the 'Import' button on the left-hand side and choose 'WordPress'.
2.  If you haven't authorized Junia already, you will be prompted to authorize Junia to access your content in WordPress following this [guide](https://www.junia.ai/docs/publish-your-article).
3.  Once you have done so, enter the ID or Slug of your Post in WordPress and hit "submit". The content will be automatically imported into Junia AI.

Check formatting after import. Then use [AI Co-write](/docs/ai-co-write) to expand or rewrite.

## Need help?

Email [support@junia.ai](mailto:support@junia.ai).

Bring HTML, Markdown, Word, or WordPress posts into the editor.

Import HTML, Markdown, Word, Google Docs, or WordPress posts into the Junia editor.

Integrations

Webhooks

Connect To Wix Blog

Connect to Self-hosted WordPress Site With Username and Application Password

Fetch Articles From Junia AI API

Connect To Ghost Blog

Connect To Shopify

Include Meta Title and Meta Description For Wordpress

Connect To Webflow

Connect To Medium

Import content into Junia

Other Categories

Getting Started

Autoblog

Research & Planning

AI Article Writer