linkedin/
profile-posts

Находите публичные публикации, связанные с URL профилей LinkedIn, и получайте нормализованный текст, данные автора, медиа, хештеги, метки времени и видимую вовлеченность.

LinkedIn Profile Posts API

Поиск по URL профиля
Фильтр собственных публикаций
Лимиты на профиль
1 кредит за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

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 профилей и параметры поиска, отслеживайте асинхронную задачу и постранично читайте сохраненные нормализованные публикации.

  1. Подготовьте один или несколько публичных URL профилей LinkedIn, пути которых начинаются с /in/.
  2. Выберите only_authored_posts и results_limit от 1 до 2 000 на каждый профиль; строки дат для источника добавляйте только при необходимости.
  3. Отправьте запрос методом POST на /v1/linkedin/profile-posts и опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте 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 от нуля для меток времени и метрик и допускайте пустые медиа, хештеги или упоминания.
  • Не делайте выводов об экспертизе, статусе занятости, тональности, качестве лидов, влиянии или эффективности контента только по нормализованной выборке.

Помимо 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 публикаций, в которых эти видео размещены.

Другие платформы

Объединяйте данные LinkedIn с публичными данными других поддерживаемых соцсетей.

LinkedIn Profile Posts API — FAQ

LinkedIn Profile Posts API — это программный интерфейс для поиска публичных публикаций, связанных с переданными URL профилей LinkedIn, который возвращает нормализованный контент, данные автора, медиа, метки времени и видимую вовлеченность.

Передайте один или несколько URL со схемой http или https на linkedin.com или поддомене LinkedIn, путь которых начинается с /in/. Страницы компаний и URL публикаций не входят в спецификацию входных данных этого эндпоинта.

Если значение равно true, оно передается источнику, чтобы запросить публикации, автором которых он считает целевой профиль. Это не независимая проверка личности со стороны SocQ, поэтому проверяйте возвращенные поля автора, когда авторство существенно.

Нет. SocQ передает непустые строки, не разбирая их формат, не сравнивая порядок и не определяя включительность границ и часовые пояса; фильтрацию определяет поведение источника.

Нет. По умолчанию он равен 100 и принимает значения от 1 до 2 000 для каждого URL отдельно, поэтому общий объем задачи может равняться лимиту на профиль, умноженному на число профилей.

Нет. Это значит, что для переданного профиля и фильтров в этом запуске не было показано пригодных публичных публикаций; на охват могут влиять видимость и условия источника.

Каждая успешно сохраненная публикация стоит 1 кредит SocQ, базовой платы нет. Оценка исходит из потолка результатов на профиль, а итоговая оплата — из фактически сохраненных результатов; за пустой результат плата не взимается.