Skip to Content
Open API (Legacy)ExposureSocial Posting

Social Posting

Social Posting 데이터를 가져오기 위한 API입니다.

Authentication

API에 접근하기 위해 API Key가 필합니다. 예시:

curl -X GET https://app-api.commerceos.ai/open/v1/exposures/social-posting \
     -H "x-api-key: YOUR_API_KEY"

Endpoints

Get User

Endpoint: GET /open/v1/exposures/social-posting

Request

FieldTypeRequiredDescription
x-api-key (Header)stringYes사용자별 API Key.
startDate (Body)LocalDateYes검색할 Posting의 시작 날짜입니다.
endDate (Body)LocalDateYes검색할 Posting의 마지막 날짜입니다.
dateType (Body)stringNoenum(CollectedAt, PostedAt) 검색 기준을 설정합니다. (Default. PostedAt)

Example Request

curl -X GET https://app-api.commerceos.ai/open/v1/exposures/social-posting?startDate=2024-01-01&endDate=2024-11-27 \
     -H "x-api-key: YOUR_API_KEY"

Response

FieldTypeRequiredDescription
startDateLocalDateTimeYes조회 기간의 시작 날짜입니다. ISO 8601 형식(YYYY-MM-DD)으로 제공됩니다.
endDateLocalDateTimeYes조회 기간의 종료 날짜입니다. ISO 8601 형식(YYYY-MM-DD)으로 제공됩니다.
resultarray SocialPostingResultYesSocialPostingResult 객체의 배열입니다.
  • SocialPostingResult
FieldTypeRequiredDescription
idnumberYes고유 ID입니다.
postDatestringYes게시물이 작성된 날짜와 시간입니다. ISO 8601 형식 (YYYY-MM-DDTHH:mm:ss+zoneoffset)으로 제공됩니다.
collectTimestringYes데이터를 수집한 날짜와 시간입니다. ISO 8601 형식으로 제공됩니다.
shareLinkstringYes게시물에 대한 공유 링크입니다.
platformstringYes게시물이 게시된 플랫폼입니다. 예: x.
platformArticleIdstringYes각 플랫폼별 식별 번호 (Facebook은 공개된 고유 식별자가 없어, Content의 Hash로 구성됩니다.)
regionstringYes게시물이 작성된 지역입니다. 예: N.Am.
countrystringYes게시물이 작성된 국가입니다.
namestringYes계정 이름입니다. 예: t-mobile.
followerCountlongYes계정의 follower 수 입니다.
contentstringYes게시물의 본문 내용입니다.
hashtagarrayYes게시물에 포함된 해시태그의 배열입니다.
brandstringYes게시물에서 언급된 브랜드 이름입니다. (해당하지 않을 경우 other)
brandListstringYes브랜드 리스트입니다.
reasonstringYes브랜드와의 관련성을 판단한 이유입니다.
productNamestringYes게시물에서 언급된 제품 이름입니다.
productCategorystringYes게시물에서 언급된 제품의 카테고리입니다.
imagestringNo게시물과 관련된 이미지 링크입니다.
videostringNo게시물과 관련된 동영상 링크입니다.
summarystringYes게시물 내용의 요약입니다.
likeCountnumberNo게시물의 좋아요 수입니다.
commentCountnumberNo게시물의 댓글 수입니다.
shareCountnumberNo게시물의 공유 수입니다.
screenshotstringNo게시물의 스크린샷 이미지 링크입니다.
postingTypestringYes게시물의 유형입니다. 예: POSTING, STORY.
  • Status: 200 OK
  • Body:
{
    "startDate": "2024-01-01",
    "endDate": "2024-11-27",
    "result": [
        {
            "id": 17746898995642368,
            "postDate": "2024-04-01T17:26:46",
            "collectTime": "2024-11-06T03:49:24",
            "shareLink": "https://www.x.com/tmobile/status/1774850907274142181",
            "platform": "x",
            "region": "N.Am",
            "name": "t-mobile",
            "content": "oops, had my notifications turned off 🤷",
            "hashtag": [],
            "brand": "other",
            "brandList": "",
            "reason": "The input text does not mention any specific brand related to electronic devices.",
            "productName": "",
            "productCategory": "",
            "image": "",
            "video": "",
            "summary": "The user mentions having their notifications turned off.",
            "likeCount": 118,
            "commentCount": 47,
            "shareCount": 16,
            "screenshot": "https://collected-data.commerceos.ai/samsung/sns/2024/11/08/12/x/t-mobile/PC/2024-04-01/1774850907274142181/images/screenshot.png",
            "postingType": "POSTING"
        }
    ]
}
Last updated on
Search ShareContent Scoring