LinkedIn Profile Posts
Лента, связанная с профилем LinkedIn, может содержать собственные публикации, репосты, статьи, изображения, видео, документы и другую публичную активность со страницы участника. Возвращаемые записи дают выборку на момент сбора для исследования контента, но не представляют полную историю активности, закрытую аналитику или контент, видимый только контактам.
Возможности LinkedIn Profile Posts API
- Поиск по URL профилейПринимает один или несколько публичных URL LinkedIn вида /in/ и находит публикации, связанные с каждым переданным профилем.
- Необязательный фильтр собственных публикацийПередает only_authored_posts, чтобы сузить связанную активность до публикаций, автором которых источник считает целевой профиль.
- Периоды дат на стороне источникаПередает необязательные строки start_date и end_date для фильтрации на стороне источника, не навязывая собственный формат, порядок, включительность или правило часового пояса.
- Нормализованный контекст контентаВозвращает доступный текст публикации, поля автора, время публикации, медиа, хештеги, упоминания и исходный URL в стабильной схеме публикации.
- Снимки видимой вовлеченностиХранит доступные лайки, комментарии, репосты и просмотры вместе с collected_at, чтобы измерения оставались привязаны ко времени наблюдения.
Параметры LinkedIn Profile Posts API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательный список URL публичных профилей LinkedIn на хостах LinkedIn с путями, начинающимися с /in/. |
start_date | Необязательный | Необязательная непустая строка фильтра по дате для источника, передаваемая для каждого входного профиля; SocQ не разбирает и не проверяет ее формат или включительность. |
end_date | Необязательный | Необязательная непустая строка фильтра по дате для источника, передаваемая для каждого входного профиля; SocQ не проверяет ее порядок относительно start_date. |
only_authored_posts | Необязательный | Необязательное логическое значение, передаваемое для каждого профиля; true запрашивает публикации, автором которых источник считает профиль, но не является проверкой личности на стороне SocQ. |
results_limit | Необязательный | Необязательное целое число от 1 до 2 000, применяемое к каждому URL профиля отдельно; по умолчанию 100 на профиль. |
Как использовать LinkedIn Profile Posts API
Отправьте URL профилей и параметры поиска, отслеживайте асинхронную задачу и постранично читайте сохраненные нормализованные публикации.
- Подготовьте один или несколько публичных URL профилей LinkedIn, пути которых начинаются с /in/.
- Выберите only_authored_posts и results_limit от 1 до 2 000 на каждый профиль; строки дат для источника добавляйте только при необходимости.
- Отправьте запрос методом POST на /v1/linkedin/profile-posts и опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте data.results.items и продолжайте с next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/linkedin/profile-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/in/satyanadella/"],"only_authored_posts":true,"results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования LinkedIn Profile Posts API
- Анализ публичных коммуникаций: Изучайте темы, утверждения, ссылки и повторяющиеся формулировки в возвращенных публикациях, связанных с выбранными профессиональными профилями.
- Выборка собственного контента: Используйте only_authored_posts, чтобы запросить более узкую выборку, а затем проверяйте возвращенные поля автора, когда авторство важно.
- Исследование форматов и медиа: Сравнивайте доступные изображения, видео, документы, статьи, хештеги и упоминания в заданном наборе возвращенных записей.
- Снимки вовлеченности за период: Применяйте строки дат источника и сравнивайте видимую вовлеченность только внутри собранной выборки, сохраняя published_at и collected_at.
Практические советы по LinkedIn Profile Posts API
- Считайте results_limit потолком на каждый профиль: пять URL с лимитом 20 могут сохранить до 100 публикаций.
- Передавайте даты как строки для источника и документируйте собственное соглашение, потому что SocQ не проверяет их формат, порядок, границы или часовой пояс.
- Проверяйте возвращенного автора, если only_authored_posts важен: флаг запрашивает фильтрацию у источника, а не подтверждает личность.
- Храните collected_at рядом с метриками вовлеченности, потому что видимые значения могут меняться между запусками.
- Отличайте null от нуля для меток времени и метрик и допускайте пустые медиа, хештеги или упоминания.
- Не делайте выводов об экспертизе, статусе занятости, тональности, качестве лидов, влиянии или эффективности контента только по нормализованной выборке.
Связанные API
Помимо LinkedIn Profile Posts API, используйте эти API, когда нужен другой тип публичных данных LinkedIn.
- LinkedIn Profiles API — Нормализуйте по URL профилей публичные данные: личность, должности, местоположение, видимое число аудитории, опыт, образование и навыки.
- LinkedIn Companies API — Нормализуйте публичные описания компаний, сайты, логотипы, видимое число подписчиков и сотрудников, отрасли, местоположения и специализации.
- LinkedIn Posts API — Собирайте по поддерживаемым URL текст публичных публикаций, авторов, видимую вовлеченность, медиа, время публикации, тип и хештеги.
- LinkedIn Company Posts API — Находите публичные публикации по URL страниц компаний LinkedIn: текст, контекст автора, медиа, хештеги, метки времени и видимая вовлеченность.
- LinkedIn Post Comments API — Собирайте публичные комментарии к известной публикации LinkedIn: текст, контекст автора, метки времени, ID связей и видимое число лайков и ответов.
- LinkedIn Video Transcript API — Превращайте субтитры видео LinkedIn в простой текст по URL публикаций, в которых эти видео размещены.