Custom API Publishing
AEOBot's Custom API integration lets you publish articles to any web application — Next.js, Nuxt, Remix, Express, Django, or anything else.
How It Works
Setup for Next.js (App Router)
Create the API Route
Create a file at app/api/aeobotai/route.ts in your project with GET (health check) and POST (receive articles) handlers. Authenticate using a Bearer token from environment variables.
Set Your Secret Key
Add AEOBOTAI_SECRET=your_random_secret_key_here to your environment variables. Generate a secure key with openssl rand -hex 32.
Deploy
Push your changes. Vercel or Netlify will auto-deploy.
Connect in AEOBot
Go to Connected Sites → Connect, select Custom API, enter your endpoint URL and secret key, test the connection, and save.
What AEOBot Sends
| Field | Type | Description |
|---|---|---|
| title | string | Article title |
| content | string | Full article in HTML |
| slug | string | URL-friendly slug |
| meta_title | string | SEO title tag |
| meta_description | string | SEO meta description |
| schema_markup | object | JSON-LD structured data |
Database Approach
For database-backed blogs, replace file-writing with a database insert. For example, with Supabase you would insert into a posts table and return the post URL.
Troubleshooting
"Endpoint not found" — Make sure the API route is deployed and the URL includes the full path.
"Authentication failed" — The secret key in AEOBot must exactly match your environment variable.
"Articles not appearing" — For file-based blogs, you may need to redeploy. For database blogs, check your rendering logic.
Frequently Asked Questions
Which frameworks does Custom API support?
Any framework with a REST API endpoint — Next.js, Nuxt, Remix, Express, Django, Rails, and more.
What data does AEOBot send?
Title, HTML content, slug, meta title, meta description, and Schema.org markup as JSON.
Do I need to redeploy after publishing?
For file-based blogs, yes. For database-based blogs, articles appear immediately.
Related Guides
WordPress Publishing
Connect your WordPress site and auto-publish articles with full SEO optimization.
Connecting Your Website
Connect your WordPress, Next.js, or custom website to AEOBot for one-click publishing.
Content Calendar & Scheduling
Plan and schedule your content publishing with the built-in content calendar.