SNS API

SNS API를 사용하여 보도자료나 블로그 기반의 SNS 콘텐츠를 자동 생성하고 관리할 수 있습니다.

인증

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

헤더 설정

PULITZER-API-KEY: YOUR_API_KEY

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

SNS 콘텐츠 생성

보도자료 또는 블로그 기반으로 SNS 콘텐츠를 자동 생성합니다. 여러 플랫폼 동시 생성이 가능합니다.

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

요청 본문

{
  "press_id": 658,
  "platforms": [
    "facebook",
    "instagram",
    "linkedin"
  ],
  "tone": "professional",
  "content_length": "medium",
  "language": "ko",
  "include_hashtags": true,
  "hashtag_count": 10
}

Request Body Parameters

파라미터	타입	필수	설명
`press_id`	integer	⚠️	보도자료 ID (press_id 또는 blog_id 중 하나 필수)
`blog_id`	integer	⚠️	블로그 ID (press_id 또는 blog_id 중 하나 필수)
`platforms`	array[string]	✅	플랫폼 목록 (facebook, instagram, threads, linkedin, x, blog)
`tone`	string	❌	톤 (professional, casual, friendly)
`content_length`	string	❌	길이 (short, medium, long)
`language`	string	❌	언어 (ko, en, ja, zh)
`include_hashtags`	boolean	❌	해시태그 포함 여부 (기본: true)
`hashtag_count`	integer	❌	해시태그 개수 (1-30, 기본: 10)

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "SNS 콘텐츠 생성 완료",
  "data": [
    {
      "id": 1,
      "platform": "facebook",
      "title": "퓰리처 AI 보도자료 생성 API 출시",
      "content": "보도자료 작성이 이렇게 쉬워진 적이 있었나요?...",
      "hashtags": [
        "#AI",
        "#보도자료",
        "#마케팅"
      ],
      "character_count": 280
    },
    {
      "id": 2,
      "platform": "instagram",
      "title": null,
      "content": "AI로 보도자료를 자동 생성하세요 ✨...",
      "hashtags": [
        "#AI",
        "#보도자료",
        "#PR자동화"
      ],
      "character_count": 150
    }
  ]
}

curl -X POST "https://api.pulitzer.ai/live/openapi/sns/generate" \
  -H "PULITZER-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "press_id": 658,
    "platforms": ["facebook", "instagram", "linkedin"],
    "tone": "professional",
    "content_length": "medium",
    "language": "ko",
    "include_hashtags": true,
    "hashtag_count": 10
  }'

SNS 콘텐츠 목록

사용자의 SNS 콘텐츠 목록을 조회합니다.

GET https://api.pulitzer.ai/live/openapi/sns/contents

Query Parameters

파라미터	타입	필수	설명
`press_id`	integer	❌	보도자료 ID 필터
`blog_id`	integer	❌	블로그 ID 필터
`platform`	string	❌	플랫폼 필터

응답

{
  "status": "SUCCESS",
  "success": true,
  "data": {
    "contents": [
      {
        "id": 1,
        "platform": "facebook",
        "title": "퓰리처 AI 출시",
        "content": "보도자료 작성이...",
        "hashtags": [
          "#AI",
          "#보도자료"
        ],
        "character_count": 280
      }
    ],
    "page_count": 1
  }
}

curl -X GET "https://api.pulitzer.ai/live/openapi/sns/contents?press_id=658&platform=instagram" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

SNS 콘텐츠 상세

SNS 콘텐츠 상세 정보를 조회합니다.

GET https://api.pulitzer.ai/live/openapi/sns/{`{content_id}`}

응답

{
  "status": "SUCCESS",
  "success": true,
  "data": {
    "id": 1,
    "platform": "facebook",
    "title": "퓰리처 AI 출시",
    "content": "보도자료 작성이 이렇게 쉬워진 적이...",
    "hashtags": [
      "#AI",
      "#보도자료",
      "#마케팅"
    ],
    "character_count": 280
  }
}

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

SNS 콘텐츠 수정

SNS 콘텐츠를 수정합니다.

PUT https://api.pulitzer.ai/live/openapi/sns/{`{content_id}`}

요청 본문

{
  "content": "수정된 SNS 콘텐츠입니다.",
  "hashtags": [
    "#AI",
    "#마케팅"
  ]
}

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "SNS 콘텐츠 수정 완료"
}

curl -X PUT "https://api.pulitzer.ai/live/openapi/sns/1" \
  -H "PULITZER-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "수정된 SNS 콘텐츠입니다.",
    "hashtags": ["#AI", "#마케팅"]
  }'

SNS 콘텐츠 삭제

SNS 콘텐츠를 삭제합니다.

DELETE https://api.pulitzer.ai/live/openapi/sns/{`{content_id}`}

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "SNS 콘텐츠 삭제 완료"
}

curl -X DELETE "https://api.pulitzer.ai/live/openapi/sns/1" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

SNS 콘텐츠 재생성

기존 SNS 콘텐츠를 AI로 재생성합니다.

POST https://api.pulitzer.ai/live/openapi/sns/{`{content_id}`}/regenerate

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "SNS 콘텐츠 재생성 완료",
  "data": {
    "id": 1,
    "platform": "facebook",
    "title": "퓰리처 AI 혁신적 출시",
    "content": "재생성된 콘텐츠...",
    "hashtags": [
      "#AI혁명",
      "#PR자동화"
    ],
    "character_count": 250
  }
}

curl -X POST "https://api.pulitzer.ai/live/openapi/sns/1/regenerate" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"