Аутрич к инфлюенсерам буксует на одних и тех же трех шагах: найти контактный адрес, связать один профиль с другими аккаунтами автора и отфильтровать длинный список по соответствию аудитории еще до того, как кто-то начнет смотреть контент. Обычно каждый шаг — это ручная работа с био, страницами link-in-bio и сайтами.
2026-11-17 SocQ запустил платформу Creator с одним эндпоинтом на каждый шаг. Все три принимают URL одного публичного профиля. В этом руководстве описано, что они возвращают, как выглядит запрос, сколько он стоит и когда использовать каждый из них.
Коротко: отправьте URL одного профиля в
urlнаPOST /v1/creator/find-emails,/find-social-profilesили/age-gender. ОпрашивайтеGET /v1/tasks/{task_id}и читайтеdata.results.items: email со страницами, на которых они найдены, связанные аккаунты с оценкой уверенности или оценку возрастного диапазона и пола.
Новые эндпоинты Creator
1 кредит SocQ = $0.005.
| Эндпоинт | Что возвращает | Входные сети | Цена |
|---|---|---|---|
| Influencer Email Finder API | Публичные рабочие email автора, каждый со страницами, на которых он найден | Instagram, TikTok, YouTube, X, Facebook | 8 кредитов ($0.04), если найден хотя бы один email; 0.5 кредита ($0.0025), если не найден ни один |
| Social Media Profile Finder API | Одна строка на каждый аккаунт автора в другой сети, с уверенностью от 0 до 1 и подтверждающими признаками | Instagram, TikTok, YouTube, X, Facebook | 8 кредитов ($0.04) за поиск |
| Age and Gender Detection API | Возрастной диапазон и пол, оцененные по фото профиля, с оценкой уверенности | Instagram, TikTok, YouTube, X, Threads | 1 кредит ($0.005) за поиск |
Для всех трех запрос к несуществующему профилю завершается ошибкой с возвратом кредитов.
Аутентификация и асинхронные задачи
Все запросы к SocQ аутентифицируются API-ключом, и один и тот же заголовок используется для отправки задачи, проверки статуса и получения результатов:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Каждый сбор данных выполняется как фоновая задача:
submit -> task_id -> queued -> running -> succeeded
\-> failed
Ответ на отправку содержит data.task_id и data.status. Опрашивайте задачу по этому ID:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Когда status равен succeeded, ответ содержит первую страницу нормализованных записей в data.results.items. По умолчанию limit равен 50, максимум 500; если has_more равно true, передайте results.next_cursor как cursor. Пока задача находится в состоянии queued, running или failed, эндпоинт возвращает метаданные задачи без results.
Необязательный callback_url в теле запроса заставляет SocQ отправить один POST со сводкой задачи после ее завершения; сами записи читайте через GET /v1/tasks/{task_id}. Тайм-аут на стороне клиента не отменяет задачу, поэтому продолжайте с тем же ID задачи, а не платите за дубликат. 402 означает недостаточно кредитов; 429 означает, что ключ достиг лимита запросов или кредитов.
Influencer Email Finder API: публичные рабочие email с источниками
Influencer Email Finder API ищет email, которые автор делает публичными: в био, на страницах link-in-bio, на связанных сайтах и в аккаунтах автора в других сетях. Укажите URL одного профиля Instagram, TikTok, YouTube, X или Facebook в url. Канал YouTube можно передать по @handle или ID канала.
curl -X POST "https://api.socq.ai/v1/creator/find-emails" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.instagram.com/miguelangeles"
}'
Если найден хотя бы один email, результат — одна строка с username, name и emails. Каждая запись в emails содержит email и source_urls — публичные страницы, где он был найден:
{
"id": "instagram:miguelangeles",
"username": "miguelangeles",
"emails": [
{
"email": "mgmt@irlangel.com",
"source_urls": [
"https://www.instagram.com/miguelangeles",
"https://www.youtube.com/@miguelangeles"
]
}
]
}
Источники позволяют команде аутрича увидеть, откуда взялся адрес, прежде чем его использовать, и отдавать предпочтение адресам, которые встречаются на нескольких собственных страницах автора. Если email не найден, задача все равно завершается успешно, не возвращает строк и стоит 0.5 кредита. Документация: Influencer Email Finder.
Social Media Profile Finder API: тот же автор в других сетях
Знаете автора по Instagram и хотите найти его TikTok и YouTube? Social Media Profile Finder API принимает имеющийся у вас профиль и возвращает по одной строке на каждый другой аккаунт, найденный для того же человека. Отправленный вами профиль в результатах не повторяется.
curl -X POST "https://api.socq.ai/v1/creator/find-social-profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.instagram.com/miguelangeles"
}'
У каждой строки есть url связанного аккаунта, network, username, confidence от 0 до 1 и evidence — признаки, связывающие аккаунты, например same_handle, website_link или reciprocal_profile_link. source_network и source_url повторяют профиль, который вы искали. Фильтруйте по confidence и evidence, чтобы оставить только совпадения, которым вы доверяете. Поиск стоит 8 кредитов независимо от числа найденных аккаунтов. Документация: Social Media Profile Finder.
Age and Gender Detection API: демографический фильтр по фото профиля
Age and Gender Detection API сортирует список авторов по демографии до того, как вы потратите время на просмотр контента. Оценка делается по лицу на фото профиля. Укажите URL одного профиля Instagram, TikTok, YouTube, X или Threads.
curl -X POST "https://api.socq.ai/v1/creator/age-gender" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://x.com/levelsio"
}'
Строка содержит network, username, age_min и age_max (оценочный возрастной диапазон в годах), gender (male или female) и gender_confidence от 0 до 100. Лучше всего эндпоинт работает с личными аккаунтами с четким портретным фото; для логотипов и групповых фото поля возраста и пола остаются пустыми. Считайте результат оценкой по фотографии, а не проверенным фактом о человеке. Документация: Age and Gender Detection.
Как объединить все три
Типичный конвейер аутрича для списка URL профилей авторов:
- Отфильтруйте список через Age and Gender Detection за 1 кредит на профиль и оставьте авторов, чья оценка подходит под вашу кампанию.
- Расширьте данные по каждому отобранному автору через Social Media Profile Finder, чтобы собрать его другие аккаунты, и оставьте совпадения выше порога уверенности.
- Свяжитесь с авторами через Influencer Email Finder и сохраните каждый email вместе с его
source_urls.
Для 100 отобранных авторов шаги 2 и 3 стоят не более 1,600 кредитов ($8.00), плюс 100 кредитов ($0.50) за шаг 1. Если у вас уже есть URL страниц link-in-bio, Link in Bio API читает такие страницы пакетно по 0.5 кредита за каждую. Более широкое сравнение поставщиков данных об авторах — в статье Альтернативы ScrapeCreators.
FAQ
Что такое API поиска email инфлюенсеров?
Это API, который принимает профиль автора в соцсети и возвращает связанные с ним публичные контактные email. Версия SocQ возвращает каждый email вместе с публичными страницами, на которых он найден.
Возвращает ли он приватные или личные email?
Он возвращает email, которые автор делает публичными — в био, на страницах link-in-bio, на связанных сайтах или в других своих аккаунтах, — вместе с этими страницами-источниками. Используйте их в соответствии с применимыми правилами о конфиденциальности и борьбе со спамом.
Списываются ли кредиты, если email не найден?
Да, 0.5 кредита. Задача завершается успешно без строк. Если найден хотя бы один email, поиск стоит 8 кредитов. Запрос к несуществующему профилю завершается ошибкой с возвратом кредитов.
Насколько надежны связанные профили?
У каждого совпадения есть confidence от 0 до 1 и evidence, на котором оно основано, например взаимные ссылки между профилями. Задайте собственный порог и храните подтверждающие признаки вместе с совпадением.
Почему для некоторых профилей возраст и пол пустые?
Оценка делается по лицу на фото профиля. Для логотипов и групповых фото поля возраста и пола остаются пустыми.
CREATOR API
Проверить сценарий на публичном URL Creator
Отправляйте публичные входные данные и получайте нормализованные записи с отслеживаемым источником.
API для Creator