Main API
AI 리포트 API
AI 기반 마케팅 리포트 생성 API
AI 리포트 API
AI를 활용한 마케팅 리포트 생성 API입니다.
Base URL: /ai/report
인증 정보
| 항목 | 값 |
|---|---|
| 인증 필요 | 부분적 |
| 인증 방식 | JWT Bearer Token |
엔드포인트 목록
리포트 생성
| 메서드 | 경로 | 설명 | 인증 |
|---|---|---|---|
POST | /ai/report | 마케팅 리포트 생성 | 불필요 |
POST | /ai/report/country/{country} | 국가별 리포트 생성 | 불필요 |
POST | /ai/report/campaign/opportunity-analysis | 기회 분석 리포트 | 불필요 |
POST | /ai/report/policy | 정책 리포트 | 불필요 |
POST | /ai/report/AZ | AZ 리포트 | 불필요 |
POST | /ai/report/small-business | 소상공인 리포트 | 불필요 |
POST | /ai/report/recheck | 재검토 리포트 | 불필요 |
POST | /ai/report/micro | 마이크로 카테고리 리포트 | 불필요 |
POST | /ai/report/budget | 예산 리포트 | 불필요 |
SNS 분석
| 메서드 | 경로 | 설명 | 인증 |
|---|---|---|---|
GET | /ai/report/sns-analysis/category | SNS 카테고리 분석 | 불필요 |
POST | /ai/report/sns-analysis | SNS 분석 리포트 | 불필요 |
기타
| 메서드 | 경로 | 설명 | 인증 |
|---|---|---|---|
PATCH | /ai/report/log/bind-member | 로그 멤버 연결 | 필요 |
POST | /ai/report/member | 멤버 정보 로깅 | 불필요 |
POST | /ai/report/category | 브랜드 카테고리 추출 | 불필요 |
POST | /ai/report/cold-mail | 콜드메일 1차 생성 | 불필요 |
POST | /ai/report/cold-mail-v2 | 콜드메일 2차 생성 | 불필요 |
API 상세
마케팅 리포트 생성
브랜드 링크를 분석하여 마케팅 리포트를 생성합니다.
HTTP 요청
POST /ai/report
Content-Type: application/jsonRequest Body
{
"brandLink": "https://example-brand.com"
}Request Body 스키마
| 필드명 | 타입 | 필수 | 설명 |
|---|---|---|---|
brandLink | string | 예 | 브랜드 웹사이트 URL |
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "pdf 생성이 완료되었습니다.",
"data": "https://s3.amazonaws.com/reports/report_123.pdf"
}| 필드 | 타입 | 설명 |
|---|---|---|
data | string | 생성된 PDF 리포트 URL |
에러 응답
| 상태 코드 | 코드 | 메시지 |
|---|---|---|
| 500 | SERVER_ERROR | 리포트 생성 중 오류가 발생했습니다. |
국가별 리포트 생성
특정 국가를 타겟으로 한 마케팅 리포트를 생성합니다.
HTTP 요청
POST /ai/report/country/{country}
Content-Type: application/jsonPath Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
country | string | 예 | 국가 코드 (예: KR, US, JP) |
Request Body
{
"brandLink": "https://example-brand.com"
}응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "pdf 생성이 완료되었습니다.",
"data": "https://s3.amazonaws.com/reports/report_country_123.pdf"
}SNS 카테고리 분석
SNS 링크를 분석하여 카테고리를 추출합니다.
HTTP 요청
GET /ai/report/sns-analysis/category?snsLink={sns_url}Query Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
snsLink | string | 예 | SNS 계정 URL |
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "sns 계정 조회가 완료되었습니다.",
"data": {
"crawlResult": {
"followerCount": 50000,
"postCount": 300,
"profileImage": "https://..."
},
"category": "뷰티"
}
}SNS 분석 리포트
SNS 계정 분석 리포트를 생성합니다.
HTTP 요청
POST /ai/report/sns-analysis
Content-Type: application/jsonRequest Body
{
"snsLink": "https://instagram.com/example",
"category": "뷰티"
}응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "pdf 생성이 완료되었습니다.",
"data": "https://s3.amazonaws.com/reports/sns_analysis_123.pdf"
}콜드메일 1차 생성
브랜드 분석을 기반으로 콜드메일 초안을 생성합니다.
HTTP 요청
POST /ai/report/cold-mail
Content-Type: application/jsonRequest Body
{
"brandLink": "https://example-brand.com"
}응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "콜드메일 1차 생성이 완료되었습니다.",
"data": {
"subject": "이메일 제목",
"body": "이메일 본문 내용..."
}
}콜드메일 2차 생성
추가 정보를 바탕으로 콜드메일을 최종 완성합니다.
HTTP 요청
POST /ai/report/cold-mail-v2
Content-Type: application/jsonRequest Body
{
"brandLink": "https://example-brand.com",
"additionalInfo": "추가 정보",
"tone": "formal"
}응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "콜드메일 2차 생성이 완료되었습니다.",
"data": "최종 완성된 콜드메일 내용..."
}브랜드 카테고리 추출
브랜드 링크에서 카테고리를 추출합니다.
HTTP 요청
POST /ai/report/category
Content-Type: application/jsonRequest Body
{
"brandLink": "https://example-brand.com"
}응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "카테고리 추출이 완료되었습니다.",
"data": "뷰티"
}리포트 종류
| 리포트 | 엔드포인트 | 설명 |
|---|---|---|
| 마케팅 리포트 | /ai/report | 기본 마케팅 분석 |
| 국가별 리포트 | /ai/report/country/{country} | 특정 국가 타겟 분석 |
| 기회 분석 | /ai/report/campaign/opportunity-analysis | 캠페인 기회 분석 |
| 정책 리포트 | /ai/report/policy | 정책 관련 분석 |
| AZ 리포트 | /ai/report/AZ | AZ 분석 |
| 소상공인 리포트 | /ai/report/small-business | 소상공인 맞춤 분석 |
| 재검토 리포트 | /ai/report/recheck | 재검토용 분석 |
| 마이크로 리포트 | /ai/report/micro | 마이크로 카테고리 분석 |
| 예산 리포트 | /ai/report/budget | 예산 분석 |