SemanticPen API Documentation

Example Requests

Basic Article Generation

fetch("https://www.semanticpen.com/api/articles", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    targetKeyword: ["sustainable living tips", "eco-friendly lifestyle"],
    articleMode: "Bulk Writer",
    language: "english",
    country: "United States",
    toneOfVoice: "informative",
    pointOfView: "secondPerson",
    includeTableOfContent: true,
    includeFAQSection: true,
    aiSeoOptimzation: true,
    projectName: "Sustainability Blog Series",
    personalisationName: "eco-brand-voice"
  }),
});

Bulk Article Generation with Media

fetch("https://www.semanticpen.com/api/articles", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    targetKeyword: ["digital marketing trends", "SEO best practices", "content marketing"],
    articleMode: "Bulk Writer",
    projectName: "Marketing Blog Q1 2024",
    mediaPreference: "Images",
    maxImages: 3,
    imageStyle: "photographic",
    imageSize: "1024x1024",
    imageProvider: "stock-pixabay",
    brandVoice: "Professional and authoritative tone with actionable insights",
    targetAudience: "Marketing professionals and business owners",
    language: "english",
    country: "United States",
    toneOfVoice: "professional",
    includeTableOfContent: true,
    includeFAQSection: true,
    aiSeoOptimzation: true
  }),
});

Article Generation with WordPress Integration

fetch("https://www.semanticpen.com/api/articles", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    targetKeyword: "productivity tips for remote workers",
    articleMode: "Bulk Writer",
    projectName: "Remote Work Blog",
    integrationData: {
      integrationType: "WordPress",
      websiteID: "your-website-id",
      categoryName: ["Productivity", "Remote Work"],
      tagNames: ["productivity", "remote", "work-from-home"],
      authorName: "John Doe",
      postStatus: "draft",
      publishImmediately: false,
      scheduleStartDate: "2024-01-15",
      scheduleEndDate: "2024-01-30",
      postFrequency: "daily"
    },
    language: "english",
    country: "United States",
    toneOfVoice: "friendly",
    pointOfView: "secondPerson",
    includeTableOfContent: true,
    includeFAQSection: true,
    aiSeoOptimzation: true
  }),
});

Amazon Product Review Article

fetch("https://www.semanticpen.com/api/articles", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    targetKeyword: "best eco-friendly water bottle",
    articleMode: "Amazon Product Review Articles",
    amazonProductURL: "https://www.amazon.com/Redragon-S101-Keyboard-Ergonomic-Programmable/dp/B00NLZUM36/",
    amazonAffiliateTag: "your-affiliate-tag-20",
    language: "english",
    country: "United States",
    toneOfVoice: "persuasive",
    pointOfView: "firstPersonSingular",
    includeTableOfContent: true,
    includeFAQSection: true,
    aiSeoOptimzation: true
  }),
});

YouTube to Article

fetch("https://www.semanticpen.com/api/articles", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    targetKeyword: "machine learning basics",
    articleMode: "Youtube to Article",
    youtubeVideoURL: "https://www.youtube.com/watch?v=creuUvqslYg",
    language: "english",
    country: "United States",
    toneOfVoice: "educational",
    pointOfView: "thirdPerson",
    includeTableOfContent: true,
    includeFAQSection: true,
    aiSeoOptimzation: true
  }),
});