LinkedIn Search Posts
LinkedIn 게시물 검색은 업스트림의 Google 색인 기반 탐색 방식으로 키워드 쿼리 하나에 해당하는 공개 페이지를 찾은 뒤, 사용 가능한 게시물 레코드를 추출합니다. 결과는 LinkedIn의 개인화된 자체 검색이나 전체 아카이브가 아니라 순위가 매겨진 수집 시점 표본이므로, 전체 대화량·도달·감정·점유율로 해석해서는 안 됩니다.
LinkedIn Search Posts API 주요 기능
- 키워드 중심 탐색필수인 주제·조직·제품·인물·문구 쿼리 하나(비어 있지 않아야 함)로 공개 색인된 LinkedIn 페이지를 검색합니다.
- 선택 상대 날짜date_posted 문자열을 제공자에게 전달합니다. 문서화된 값은 last-hour, last-day, last-week, last-month, last-year입니다.
- 페이지 단위에 맞춘 제한results_limit을 10부터 2000까지 10의 배수로 지정할 수 있으며, 기본값은 10이고 허용되는 값이 제공자의 수집 범위를 보장하지는 않습니다.
- 표준 게시물 레코드안정적인 콘텐츠, 작성자, 지표, 미디어, 해시태그, 멘션, 게시, 수집 필드를 받습니다.
- 커서 기반 수집요청한 상한, 마지막 페이지 또는 빈 페이지, 커서 누락, 커서 반복이 수집을 멈출 때까지 제공자 커서를 따라갑니다.
LinkedIn Search Posts API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
query | 필수 | 공개 색인 게시물 탐색에 사용하는 키워드 또는 문구로, 비어 있지 않아야 하는 필수 값입니다. |
date_posted | 선택 | 제공자에게 그대로 전달되는 선택 사항의 상대 날짜 문자열로, 비어 있지 않아야 합니다. SocQ는 제공자가 문서화한 값을 자체적으로 강제하지 않습니다. |
results_limit | 선택 | 선택 사항의 정수 결과 상한입니다. 기본값은 10이고 10부터 2000까지 허용되며, 제공자의 페이지 크기인 10건의 배수여야 합니다. |
LinkedIn Search Posts API 사용 방법
키워드 쿼리 하나를 제출하고, 비동기 작업을 폴링한 뒤, 반환된 탐색 표본을 검토합니다.
- 비어 있지 않은 query 하나를 정하고, 필요하면 제공자의 상대 날짜 문자열을 선택합니다.
- query, date_posted, 10건 단위의 제한을 /v1/linkedin/search-posts로 POST하고, task_id를 저장합니다.
- 작업이 최종 상태에 도달할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 성공하면 data.results.items를 처리하고, has_more가 true일 때마다 next_cursor를 따라갑니다.
curl -X POST "https://api.socq.ai/v1/linkedin/search-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"AI agents","date_posted":"last-week","results_limit":10}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueLinkedIn Search Posts API 추천 활용 사례
- 주제 탐색: 선택한 주제, 제품, 조직, 인물 또는 문구를 언급한 공개 색인 게시물을 찾습니다.
- 메시지·형식 검토: 표본을 전체로 간주하지 않으면서, 반환된 주장, 해시태그, 작성자, 링크, 미디어 형식을 살펴봅니다.
- 작성자·URL 선별: 수동 후속 조치나 작성자별 수집에 쓸 공개 작성자와 게시물 URL을 식별합니다.
- 토론 수집으로 넘기기: 관련 있는 결과 URL을 골라, 공개 토론 레코드가 필요할 때 LinkedIn Post Comments에 전달합니다.
LinkedIn Search Posts API 활용 팁
- 탐색 표본을 비교할 때는 같은 query, 날짜 문자열, 결과 제한, 수집 일정을 사용하세요.
- 업스트림 순서는 중립적인 인기도·최신성·관련도 점수가 아니라 검색 순위로 취급하세요.
- 성공했지만 비어 있는 결과를 조건에 맞는 LinkedIn 게시물이 없다는 증거로 해석하지 마세요.
- 색인된 페이지는 오래되었거나, 잘렸거나, 삭제되었거나, 제한되어 있을 수 있으므로 중요한 텍스트와 미디어는 원본 게시물에서 확인하세요.
- 누락된 참여 수치는 0이 아니라 알 수 없는 값으로 취급하고, 모든 스냅샷에 collected_at을 함께 보관하세요.
- 대상 게시자를 이미 알고 있다면 company-posts 또는 profile-posts를 사용하세요.
관련 API
LinkedIn Search Posts API 외에 LinkedIn의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- LinkedIn Profiles API — 프로필 URL에서 공개 프로필 정보, 직무, 위치, 공개된 오디언스 수, 경력, 학력, 스킬을 정규화합니다.
- LinkedIn Companies API — 공개 회사 소개, 웹사이트, 로고, 공개된 팔로워 및 직원 수, 산업, 위치, 전문 분야를 정규화합니다.
- LinkedIn Posts API — 지원되는 URL에서 공개 게시물 텍스트, 작성자, 공개된 참여도, 미디어, 게시 시각, 유형, 해시태그를 수집합니다.
- LinkedIn Jobs API — 공개 채용 공고의 직무명, 회사, 설명, 위치, 자격 요건, 고용 정보, 지원 링크, 확인 가능한 연봉 필드를 정규화합니다.
- LinkedIn Post Comments API — 알고 있는 LinkedIn 게시물에 노출된 공개 댓글을 수집하며, 텍스트, 작성자 맥락, 타임스탬프, 관계 ID, 공개된 좋아요 및 답글 수를 포함합니다.
- LinkedIn Search People API — LinkedIn 인물 검색 URL에서 공개 프로필 후보를 찾고, 정규화된 계정 정보, 소개, 이미지, 위치, 웹사이트, 계정 신호, 확인 가능한 지표를 반환합니다.