LinkedIn Search Posts
LinkedIn Search Posts использует внешний метод поиска по индексу Google, чтобы найти публичные страницы по одному запросу с ключевым словом, а затем извлекает доступные записи публикаций. Результат — это ранжированная выборка на момент сбора, а не персонализированный встроенный поиск LinkedIn и не полный архив, поэтому ее не следует считать общим объемом обсуждений, охватом, тональностью или долей голоса.
Возможности LinkedIn Search Posts API
- Поиск от ключевого словаИщите публично проиндексированные страницы LinkedIn по одному обязательному непустому запросу: теме, организации, продукту, человеку или фразе.
- Необязательная относительная датаПередает провайдеру строку date_posted; в документации указаны значения last-hour, last-day, last-week, last-month и last-year.
- Лимиты, кратные страницеЗадайте results_limit от 10 до 2 000 с шагом 10; по умолчанию 10, и допустимое значение не гарантирует соответствующего охвата у провайдера.
- Канонические записи публикацийПолучайте стабильные поля контента, автора, метрик, медиа, хештегов, упоминаний, публикации и сбора.
- Сбор с учетом курсораПереходит по курсорам провайдера, пока сбор не остановят запрошенный лимит, последняя или пустая страница, отсутствующий или повторившийся курсор.
Параметры LinkedIn Search Posts API
| Параметры | Обязательный | Описание |
|---|---|---|
query | Обязательный | Обязательное непустое ключевое слово или фраза для поиска публичных проиндексированных публикаций. |
date_posted | Необязательный | Необязательная непустая строка относительной даты, которая передается провайдеру. SocQ не проверяет самостоятельно значения из документации провайдера. |
results_limit | Необязательный | Необязательный целочисленный лимит результатов. По умолчанию 10, допускаются значения от 10 до 2 000, кратные размеру страницы провайдера в 10 записей. |
Как использовать LinkedIn Search Posts API
Отправьте один запрос с ключевым словом, опрашивайте асинхронную задачу и изучите полученную выборку.
- Выберите один непустой query и при необходимости строку относительной даты провайдера.
- Отправьте query, date_posted и значение, кратное 10 записям, методом POST на /v1/linkedin/search-posts и сохраните task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в конечный статус.
- После успешного завершения обработайте data.results.items и переходите по next_cursor, пока has_more равно true.
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 trueСценарии использования LinkedIn Search Posts API
- Поиск по теме: Находите публично проиндексированные публикации, в которых упоминается выбранная тема, продукт, организация, человек или фраза.
- Анализ сообщений и форматов: Изучайте утверждения, хештеги, авторов, ссылки и форматы медиа в результатах, не считая выборку исчерпывающей.
- Отбор авторов и URL: Определяйте публичных авторов и URL публикаций для ручной проработки или сбора данных по конкретному автору.
- Передача к обсуждениям: Отбирайте релевантные URL из результатов и передавайте их в LinkedIn Post Comments, когда нужны записи публичных обсуждений.
Практические советы по LinkedIn Search Posts API
- Используйте одинаковые запрос, строку даты, лимит результатов и расписание сбора, когда сравниваете выборки.
- Считайте порядок из источника поисковым ранжированием, а не нейтральной оценкой популярности, свежести или релевантности.
- Не считайте успешный пустой результат доказательством того, что подходящих публикаций LinkedIn не существует.
- Проверяйте важный текст и медиа в исходной публикации: проиндексированные страницы могут быть устаревшими, обрезанными, удаленными или закрытыми.
- Считайте отсутствующие значения вовлеченности неизвестными, а не нулевыми, и сохраняйте collected_at с каждым снимком.
- Используйте company-posts или profile-posts, если нужный автор публикаций уже известен.
Связанные API
Помимо LinkedIn Search Posts API, используйте эти API, когда нужен другой тип публичных данных LinkedIn.
- LinkedIn Profiles API — Нормализуйте по URL профилей публичные данные: личность, должности, местоположение, видимое число аудитории, опыт, образование и навыки.
- LinkedIn Companies API — Нормализуйте публичные описания компаний, сайты, логотипы, видимое число подписчиков и сотрудников, отрасли, местоположения и специализации.
- LinkedIn Posts API — Собирайте по поддерживаемым URL текст публичных публикаций, авторов, видимую вовлеченность, медиа, время публикации, тип и хештеги.
- LinkedIn Jobs API — Нормализуйте публичные вакансии: должность, компания, описание, местоположение, требования, условия занятости, ссылки для отклика и доступные поля зарплаты.
- LinkedIn Post Comments API — Собирайте публичные комментарии к известной публикации LinkedIn: текст, контекст автора, метки времени, ID связей и видимое число лайков и ответов.
- LinkedIn Search People API — Находите публичные профили кандидатов по URL поиска людей в LinkedIn и получайте нормализованные данные личности, описание, изображения, местоположение, сайт, признаки аккаунта и доступные метрики.