Referensi API

Name: SeoAuto.ai
Brand: SeoAuto.ai

Referensi lengkap untuk AutoSEO REST API. Semua endpoint memerlukan token Bearer yang valid kecuali dinyatakan lain. URL Dasar: https://panel.seoauto.ai

Gambaran Umum

AutoSEO PSEO Automation API memungkinkan Anda membuat situs web (PSEO) secara programatis, memicu pembuatan konten berbasis AI, melacak pekerjaan pembuatan, dan mengelola pipeline konten Anda. Semua endpoint berada di bawah awalan jalur /pseo-endpoints, dipasang di backend Directus.

URL Dasar

https://panel.seoauto.ai

Autentikasi

Bearer Token (JWT)

Format

JSON (REST)

Autentikasi

Semua panggilan API (kecuali pemeriksaan kesehatan) memerlukan token pengguna Directus yang diteruskan sebagai header Bearer. Dapatkan token akses berumur pendek dengan masuk, atau gunakan token statis berumur panjang yang dihasilkan dari dasbor Anda.

Opsi 1 — Masuk (JWT berumur pendek)

POSThttps://panel.seoauto.ai/auth/login

json — request body

{
  "email": "you@example.com",
  "password": "••••••••"
}

json — response

{
  "data": {
    "access_token": "eyJhbGciO...",
    "expires": 3600000,
    "refresh_token": "..."
  }
}

Opsi 2 — Token statis (dasbor)

Buka Dasbor → Kunci API dan buat token statis permanen. Gunakan langsung sebagai nilai Bearer — tidak ada kedaluwarsa yang perlu dilacak.

Menggunakan token

http header

Authorization: Bearer <your_access_token>

Pemeriksaan Kesehatan

GEThttps://panel.seoauto.ai/pseo-endpoints/

Mengembalikan status ekstensi dan daftar endpoint yang tersedia. Tidak memerlukan autentikasi.

json — response 200

{
  "status": "ok",
  "extension": "pseo-automation",
  "version": "1.0.0",
  "timestamp": "2026-03-10T12:00:00.000Z",
  "endpoints": [
    "GET /",
    "POST /pseo",
    "POST /trigger/on-demand-generation",
    "POST /trigger/bulk-generation",
    "GET /generations/:id",
    "GET /generations?pseo_id=X",
    "POST /generate/main-json",
    "GET /fetch-sitemap?pseo_id=X"
  ]
}

Buat Situs Web

POSThttps://panel.seoauto.ai/pseo-endpoints/pseo

Membuat entri PSEO (situs web) baru untuk pengguna yang diautentikasi. Rekaman PSEO adalah entitas akar yang menyimpan semua pengaturan pembuatan konten untuk situs web tertentu.

Isi Permintaan

Bidang	Tipe	Diperlukan	Deskripsi
website_url	string	diperlukan	URL lengkap situs web target (mis. https://example.com)
master_prompt	string	diperlukan	Instruksi yang memandu AI saat membuat konten untuk situs web ini
website_software	string	opsional	Pengidentifikasi CMS/platform. Default "wordpress"

json — request body

{
  "website_url": "https://example.com",
  "website_software": "wordpress",
  "master_prompt": "This website sells handmade leather bags targeting fashion-conscious adults in the US. Write SEO-friendly product content in English using a professional yet warm tone."
}

json — response 201

{
  "success": true,
  "message": "PSEO created successfully",
  "data": {
    "id": 42,
    "website_url": "https://example.com",
    "website_software": "wordpress",
    "directus_user_id": "uuid-...",
    "post_counts_total": 0
  },
  "timestamp": "2026-03-10T12:00:00.000Z"
}

Mulai Pembuatan (Uji)

POSThttps://panel.seoauto.ai/pseo-endpoints/trigger/on-demand-generation

Memulai pekerjaan pembuatan konten AI sesuai permintaan untuk PSEO. Dibatasi 1 halaman (mode pengujian). Pekerjaan berjalan secara asinkron di latar belakang. Token dikurangi segera pada tarif token_per_page.

Mode uji — maks. 1 halaman

Pembuatan on-demand dibatasi 1 halaman dan ditujukan untuk menguji konfigurasi. Untuk membuat beberapa halaman sekaligus, gunakan endpoint Bulk Generation yang menggunakan Claude Batch API.

Isi Permintaan

Bidang	Tipe	Diperlukan	Deskripsi
pseo_id	number	diperlukan	ID PSEO (situs web) untuk membuat konten
post_count	number	diperlukan	Jumlah halaman yang akan dibuat. Harus 1 (batas pengujian)

json — request body

{
  "pseo_id": 42,
  "post_count": 1
}

json — response 202

{
  "success": true,
  "message": "Generation started in background",
  "generation_id": 7,
  "status": "pending",
  "timestamp": "2026-03-10T12:00:00.000Z"
}

Batas pembuatan bersamaan

Hanya satu pembuatan aktif per PSEO yang diizinkan sekaligus. Jika pekerjaan dengan status tertunda atau berjalan sudah ada, permintaan akan mengembalikan 409 Conflict.

Pembuatan Massal

POSThttps://panel.seoauto.ai/pseo-endpoints/trigger/bulk-generation

Memulai pekerjaan pembuatan konten AI massal menggunakan Claude Batch API. Mendukung berapa pun jumlah halaman. Token dikurangi pada tarif token_per_batch_page.

Isi Permintaan

Bidang	Tipe	Diperlukan	Deskripsi
pseo_id	number	diperlukan	ID PSEO (situs web) untuk membuat konten
post_count	number	diperlukan	Jumlah halaman yang akan dibuat (bilangan bulat positif, tanpa batas atas)

json — request body

{
  "pseo_id": 42,
  "post_count": 100
}

json — response 202

{
  "success": true,
  "message": "Bulk generation started in background",
  "generation_id": 12,
  "status": "pending",
  "timestamp": "2026-03-10T12:00:00.000Z"
}

Batas pembuatan bersamaan

Hanya satu pembuatan aktif per PSEO yang diizinkan sekaligus. Jika pekerjaan dengan status tertunda atau berjalan sudah ada, permintaan akan mengembalikan 409 Conflict.

Dapatkan Pembuatan

GEThttps://panel.seoauto.ai/pseo-endpoints/generations/:id

Mengembalikan rekaman status lengkap untuk satu pekerjaan pembuatan. Polling endpoint ini setelah memulai pembuatan untuk melacak kemajuan.

Parameter Jalur

Bidang	Tipe	Diperlukan	Deskripsi
id	number	diperlukan	generation_id yang dikembalikan oleh endpoint mulai pembuatan

json — response 200

{
  "success": true,
  "data": {
    "id": 7,
    "pseo_id": 42,
    "status": "running",        // pending | running | completed | failed
    "requested_count": 10,
    "created_count": 4,
    "failed_count": 0,
    "failed_routes": [],
    "date_created": "2026-03-10T12:00:00.000Z",
    "date_updated": "2026-03-10T12:01:30.000Z",
    "date_completed": null
  },
  "timestamp": "2026-03-10T12:01:35.000Z"
}

Status	Arti
pending	Pekerjaan dimasukkan ke antrean, belum dimulai
running	AI sedang aktif membuat halaman
completed	Semua halaman berhasil dibuat
failed	Pekerjaan dihentikan karena kesalahan kritis; periksa failed_routes

Daftar Pembuatan

GEThttps://panel.seoauto.ai/pseo-endpoints/generations?pseo_id=:pseo_id

Mengembalikan daftar hingga 50 pekerjaan pembuatan terbaru untuk PSEO tertentu, diurutkan dari yang terbaru. Hanya mengembalikan pekerjaan milik pengguna yang diautentikasi.

Parameter Kueri

Bidang	Tipe	Diperlukan	Deskripsi
pseo_id	number	diperlukan	ID PSEO (situs web) untuk mendaftar pembuatan

http — example request

GET https://panel.seoauto.ai/pseo-endpoints/generations?pseo_id=42
Authorization: Bearer <token>

json — response 200

{
  "success": true,
  "data": [
    {
      "id": 8,
      "pseo_id": 42,
      "status": "completed",
      "requested_count": 5,
      "created_count": 5,
      "failed_count": 0,
      "failed_routes": [],
      "date_created": "2026-03-10T13:00:00.000Z",
      "date_completed": "2026-03-10T13:04:21.000Z"
    },
    { "id": 7, "status": "completed", "..." : "..." }
  ],
  "timestamp": "2026-03-10T14:00:00.000Z"
}

Buat Peta Situs

POSThttps://panel.seoauto.ai/pseo-endpoints/generate/main-json

Menggunakan AI untuk membuat rencana konten terstruktur (main_json) untuk PSEO — pada dasarnya daftar rute halaman, judul, dan metadata yang akan digunakan sebagai cetak biru untuk pembuatan konten. Token dikurangi pada tarif token_per_main_json.

Isi Permintaan

Bidang	Tipe	Diperlukan	Deskripsi
pseo_id	number	diperlukan	ID PSEO target
language_code	string	diperlukan	Bahasa untuk rencana konten, mis. en-US, tr-TR, de-DE
description	string	diperlukan	Deskripsi bisnis (150–1000 karakter). Harus mencakup sektor, layanan, audiens target, dan tujuan.

json — request body

{
  "pseo_id": 42,
  "language_code": "en-US",
  "description": "We sell premium handmade leather goods including bags, wallets, and belts targeting fashion-conscious adults aged 25–45 in the United States. Our USP is ethically sourced full-grain leather with lifetime repair guarantee."
}

json — response 200

{
  "success": true,
  "message": "main_json generated and saved successfully",
  "data": {
    "main_json": {
      "pages": [
        { "route": "/leather-bags", "title": "Premium Leather Bags", "priority": 1 },
        { "route": "/leather-wallets", "title": "Handmade Leather Wallets", "priority": 2 }
      ]
    },
    "total_pages": 28
  },
  "timestamp": "2026-03-10T12:00:00.000Z"
}

Batas pembuatan bersamaan

Hanya satu pembuatan main_json per pengguna yang dapat berjalan sekaligus. Permintaan bersamaan mengembalikan 409 Conflict.

Ambil Peta Situs

GEThttps://panel.seoauto.ai/pseo-endpoints/fetch-sitemap?pseo_id=:pseo_id

Mengambil dan mengurai sitemap situs web yang terkait dengan PSEO. Mencoba beberapa jalur sitemap umum secara otomatis (termasuk indeks sitemap). Mengembalikan daftar datar dari semua URL halaman yang ditemukan. Berguna untuk mengimpor struktur URL situs web yang sudah ada.

Parameter Kueri

Bidang	Tipe	Diperlukan	Deskripsi
pseo_id	number	diperlukan	ID PSEO — sitemap diambil dari website_url yang disimpan dalam rekaman ini

Jalur sitemap yang dicoba (secara berurutan): /sitemap.xml → /sitemap_index.xml → /wp-sitemap.xml → /sitemap

http — example request

GET https://panel.seoauto.ai/pseo-endpoints/fetch-sitemap?pseo_id=42
Authorization: Bearer <token>

json — response 200

{
  "success": true,
  "urls": [
    "https://example.com/",
    "https://example.com/leather-bags",
    "https://example.com/leather-wallets",
    "https://example.com/about"
  ]
}

Mengembalikan array urls kosong jika tidak ada sitemap yang ditemukan atau situs tidak dapat dijangkau. Tidak melempar error.

Kode Kesalahan

Semua respons kesalahan mengikuti bentuk yang sama:

json — error shape

{
  "success": false,
  "error": "Human-readable error message",
  "timestamp": "2026-03-10T12:00:00.000Z"
}

Status	Arti
400Bad Request	Parameter permintaan yang hilang atau tidak valid
401Unauthorized	Token Bearer yang hilang atau tidak valid
402Payment Required	Saldo token tidak mencukupi untuk operasi yang diminta
403Forbidden	Pengguna yang diautentikasi bukan pemilik sumber daya yang diminta
404Not Found	Rekaman PSEO atau pembuatan tidak ada
409Conflict	Pekerjaan pembuatan bersamaan sudah aktif
500Internal Server Error	Kesalahan sisi server yang tidak terduga; periksa log ekstensi