> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinsearch.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Create articles from a topic or keyword

> Generate a listicle-style article from a topic, keyword, and content settings.

Use **From Keyword** when you want Pinsearch to create a listicle article from a topic and keywords.

This workflow is useful when you have a Pinterest keyword idea but do not already have your own images ready.

<Frame caption="The From Keyword tab creates a listicle from a topic, keywords, niche, item count, and image ratio.">
  <img src="https://mintcdn.com/pinsearch-3aae6db5/OcgfKRc0c-2FercO/images/ai-creation-tools/articles-from-keyword.png?fit=max&auto=format&n=OcgfKRc0c-2FercO&q=85&s=4edaf8654a4b55f15d6196a172ef9c0d" alt="Articles From Keyword tab with main topic, keywords, niche, focus, item count, image aspect ratio, and Generate Content button" width="980" height="848" data-path="images/ai-creation-tools/articles-from-keyword.png" />
</Frame>

## What to enter

* **Main Topic:** The article idea, such as `bedroom decor`.
* **Relevant Keywords:** Pinterest keywords to include in the article direction.
* **Niche:** The closest content category.
* **Focus:** Leave this on **Auto detect** unless you want a more specific structure.
* **No. of Items in Listicle:** Choose 1 to 25 items.
* **Image Aspect Ratio:** Choose the shape for AI-generated article images.

## Generate an article

<Steps>
  <Step title="Open Articles">
    Go to **Create** and open **Articles**.
  </Step>

  <Step title="Choose From Keyword">
    Select the **From Keyword** tab.
  </Step>

  <Step title="Enter your topic and keywords">
    Add the main topic and relevant keywords. Separate keywords with commas or new lines.
  </Step>

  <Step title="Choose article settings">
    Select the niche, focus, number of items, and image aspect ratio.
  </Step>

  <Step title="Generate the article">
    Review the credit estimate, then click **Generate Content**.
  </Step>
</Steps>

When generation starts, Pinsearch shows progress messages such as:

* **Generating subtopics ideas...**
* **Creating images for each subtopic...**
* **Writing descriptions and finalizing content...**
* **Putting everything together...**

The page redirects to the Article Editor when the article is ready.

## Choose a useful topic

Start with a topic that is clear enough for an article.

Good examples:

* `small apartment bedroom decor`
* `fall front porch ideas`
* `easy meal prep lunches`

Avoid starting with a topic that is too broad, such as `home`, or too long, such as a full article title with several different ideas.

## Credits

Topic-to-article generation uses **2 credits per listicle item**.

For example:

* 5 items use 10 credits.
* 10 items use 20 credits.
* 25 items use 50 credits.

Pinsearch shows the credit estimate before you generate.

## Related guides

* [Choose article length and image aspect ratio](/pinsearch-product-guides/ai-creation-tools/choose-article-length-and-image-aspect-ratio)
* [Edit and save generated articles](/pinsearch-product-guides/article-editor-and-publishing/edit-and-save-generated-articles)
* [Prepare an article for publishing](/pinsearch-product-guides/article-editor-and-publishing/prepare-an-article-for-publishing)
* [How credits are used by AI creation tools](/pinsearch-product-guides/ai-creation-tools/credits-used-by-ai-creation-tools)