SEObot Blog API Client library

Overview

Elevate your website by integrating SEObot's Blog API. This setup allows you to fetch and render real-time, SEO-optimized blog content directly into your website.

Demo

Visit the DevHunt Blog to check out an example of SEObot Blog API integration.

AI Coding Agents & Lovable Integration

Looking to integrate SEObot into your Next.js project using an AI coding agent (Lovable, Cursor, Copilot, Claude, etc.)?

Use the ready-made LLM instruction guide in the Next.js example repo - it includes all types, API usage, SSR page code, sitemap setup, and key gotchas in a single copy-paste prompt:

👉 SEObot: Next.js SSR Integration Guide for AI Agents

Prerequisites

SEObot API Key - you can find the API key in settings on app.seobotai.com

Features

• Fetch articles by page and limit.
• Retrieve articles based on categories or tags.
• Access detailed information about a specific article.
• Built-in caching mechanism for efficient data retrieval.

Installation

To install the seobot npm package, run:

npm install seobot

Usage

import { BlogClient } from 'seobot';

const client = new BlogClient('your_seobot_api_key_here');

Fetching Articles

// Note: page parameter is zero-based (0 = first page, 1 = second page, etc.)
const articles = await client.getArticles(page, limit);

Fetching Articles by Category

// Note: page parameter is zero-based (0 = first page, 1 = second page, etc.)
 const articles = await client.getCategoryArticles(categorySlug, page, limit);

Fetching Articles by Tag

// Note: page parameter is zero-based (0 = first page, 1 = second page, etc.)
const articles = await client.getTagArticles(tagSlug, page, limit);

Getting a Single Article

const article = await client.getArticle(slug);

Data Types

interface IArticle {
  id: string;
  slug: string;
  title: string;
  headline: string;
  metaDescription: string;
  metaKeywords: string;
  tags: ITag[];
  category: ICategory;
  readingTime: number;
  html: string;
  markdown: string;
  outline: string;
  deleted: boolean;
  published: boolean;
  publishedAt: string;
  createdAt: string;
  updatedAt: string;
  relatedPosts: IRelatedPost[];
  image: string;
  isTool?: boolean;
  isVideo?: boolean;
  isNews?: boolean;
}

interface ITag {
  id: string;
  title: string;
  slug: string;
}

interface ICategory {
  id: string;
  title: string;
  slug: string;
}

interface IRelatedPost {
  id: string;
  headline: string;
  slug: string;
}

Contributing

Contributions are welcome. Please open an issue or submit a pull request for any bugs, features, or improvements.

License

This project is licensed under the MIT License.

Contact

For additional assistance or information, feel free to reach out.

Revolutionize your website's content strategy with real-time, automated, SEO-optimized blog posts. Get started with SEObot AI Blog Autopilot integration today!