Blog API

Blog API를 사용하여 AI 기반 블로그를 생성하고 관리할 수 있습니다.

인증

모든 API 요청에는 PULITZER-API-KEY 헤더에 API 키가 필요합니다.

헤더 설정

PULITZER-API-KEY: YOUR_API_KEY
curl -X GET "https://api.pulitzer.ai/live/openapi/blog/list" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

블로그 AI 생성

키워드 기반 AI 블로그를 생성합니다.

POST https://api.pulitzer.ai/live/openapi/blog/generate

요청 본문

{
  "keyword": "AI 마케팅 자동화 트렌드",
  "blog_type": "marketing",
  "language": "ko",
  "target_length": "medium",
  "tone": "professional",
  "is_image": false,
  "is_search": true,
  "reference_ids": [
    1,
    2
  ]
}

Request Body Parameters

파라미터타입필수설명
keywordstring✅블로그 생성 키워드 (최대 2000자)
blog_typestring❌블로그 유형 (general, tech, marketing, news)
languagestring❌언어 (ko, en, ja, zh, 기본: ko)
target_lengthstring❌목표 길이 (short, medium, long)
tonestring❌톤 (professional, casual, friendly)
is_imageboolean❌이미지 자동 생성 여부
is_searchboolean❌웹 검색 활용 여부
reference_idsarray[integer]❌참고자료 ID 목록

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "블로그 생성 완료",
  "data": {
    "blog_id": 100,
    "title": "2026 AI 마케팅 자동화 완벽 가이드",
    "content": "인공지능 기술의 발전으로 마케팅 자동화가...",
    "content_blocks": [
      {
        "type": "text",
        "content": "인공지능 기술의 발전으로..."
      }
    ],
    "keyword": "AI 마케팅 자동화 트렌드",
    "language": "ko"
  }
}
curl -X POST "https://api.pulitzer.ai/live/openapi/blog/generate" \
  -H "PULITZER-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "AI 마케팅 자동화 트렌드",
    "blog_type": "marketing",
    "language": "ko",
    "is_search": true
  }'

블로그 AI 수정

기존 블로그를 AI로 수정합니다.

POST https://api.pulitzer.ai/live/openapi/blog/modify-ai

요청 본문

{
  "blog_id": 100,
  "modification_prompt": "더 캐주얼한 톤으로 수정해주세요"
}

Request Body Parameters

파라미터타입필수설명
blog_idinteger✅수정할 블로그 ID
modification_promptstring✅수정 요청사항 (최대 2000자)

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "블로그 수정 완료",
  "data": {
    "blog_id": 100,
    "title": "2026 AI 마케팅 자동화 완벽 가이드",
    "content": "수정된 블로그 내용..."
  }
}
curl -X POST "https://api.pulitzer.ai/live/openapi/blog/modify-ai" \
  -H "PULITZER-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "blog_id": 100,
    "modification_prompt": "더 캐주얼한 톤으로 수정해주세요"
  }'

블로그 목록 조회

사용자의 블로그 목록을 조회합니다.

GET https://api.pulitzer.ai/live/openapi/blog/list

Query Parameters

파라미터타입필수설명
pageinteger❌페이지 번호 (기본: 1)
page_sizeinteger❌페이지 크기 (1-100, 기본: 20)

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "블로그 목록 조회 성공",
  "data": {
    "blog_list": [
      {
        "id": 100,
        "title": "2026 AI 마케팅 자동화 완벽 가이드",
        "keyword": "AI 마케팅 자동화 트렌드",
        "language": "ko",
        "is_public": false,
        "created_at": 1760079885
      }
    ],
    "page_count": 5,
    "total_count": 42
  }
}
curl -X GET "https://api.pulitzer.ai/live/openapi/blog/list?page=1&page_size=10" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

블로그 상세 조회

특정 블로그의 상세 정보를 조회합니다.

GET https://api.pulitzer.ai/live/openapi/blog/{`{blog_id}`}

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "블로그 조회 성공",
  "data": {
    "id": 100,
    "title": "2026 AI 마케팅 자동화 완벽 가이드",
    "content": "인공지능 기술의 발전으로 마케팅 자동화가...",
    "content_blocks": [
      {
        "type": "text",
        "content": "인공지능 기술의 발전으로..."
      },
      {
        "type": "image",
        "image_url": "https://...",
        "caption": "AI 마케팅 도식"
      }
    ],
    "keyword": "AI 마케팅 자동화 트렌드",
    "language": "ko",
    "is_public": false,
    "created_at": 1760079885
  }
}
curl -X GET "https://api.pulitzer.ai/live/openapi/blog/100" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

블로그 삭제

블로그를 삭제합니다.

DELETE https://api.pulitzer.ai/live/openapi/blog/{`{blog_id}`}

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "블로그 삭제 성공"
}
curl -X DELETE "https://api.pulitzer.ai/live/openapi/blog/100" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

블로그 수정 히스토리

블로그의 수정 히스토리를 조회합니다.

GET https://api.pulitzer.ai/live/openapi/blog/{`{blog_id}`}/history

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "수정 히스토리 조회 성공",
  "data": [
    {
      "id": 1,
      "title": "이전 제목",
      "content": "이전 본문 내용...",
      "created_kst": "2026-05-25T14:30:00"
    }
  ]
}
curl -X GET "https://api.pulitzer.ai/live/openapi/blog/100/history" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

블로그 참고자료 관리

블로그 생성 시 참고할 자료를 등록/조회/삭제합니다.

참고자료 등록

POST https://api.pulitzer.ai/live/openapi/blog/reference
{
  "title": "마케팅 리서치 자료",
  "content": "2026년 디지털 마케팅 트렌드 리포트...",
  "url": "https://example.com/report"
}

참고자료 목록 조회

GET https://api.pulitzer.ai/live/openapi/blog/references

참고자료 삭제

DELETE https://api.pulitzer.ai/live/openapi/blog/reference/{`{reference_id}`}

응답 (목록)

{
  "status": "SUCCESS",
  "success": true,
  "data": [
    {
      "id": 1,
      "title": "마케팅 리서치 자료",
      "content": "2026년 디지털 마케팅 트렌드 리포트...",
      "url": "https://example.com/report"
    }
  ]
}
curl -X POST "https://api.pulitzer.ai/live/openapi/blog/reference" \
  -H "PULITZER-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "마케팅 리서치 자료",
    "content": "2026년 디지털 마케팅 트렌드 리포트...",
    "url": "https://example.com/report"
  }'