Skip to main content
GET
Este endpoint permite recuperar informações de qualquer perfil público de redes sociais, mesmo que esse perfil não esteja vinculado à sua conta da Ayrshare. Este recurso está disponível para Bluesky, Facebook, Instagram, LinkedIn, X e YouTube. Para perfis que estão vinculados à sua conta da Ayrshare, recomendamos usar o endpoint /analytics em vez deste, pois ele oferece analytics mais detalhados. Importante: para pesquisar um perfil em uma plataforma social específica, sua conta da Ayrshare deve ter essa rede social vinculada. Por exemplo, para pesquisar qualquer perfil do Instagram, ex. @taylorswift, você precisa ter o Instagram vinculado à sua conta da Ayrshare.
A conta pesquisada deve ser pública para que os dados possam ser acessados. Contas sociais privadas não estão disponíveis.Dados de localização só estão disponíveis para empresas com localizações públicas. Marcar uma localização no Facebook ou Instagram exige uma localização disponível.

Parâmetros do header

Parâmetros de query

array
obrigatório
Array de strings com as plataformas: bluesky, instagram, facebook, linkedin, twitter ou youtube.
string
Handle do Bluesky codificado em URL. Por exemplo: “@ayrshare” ou “ayrshare”. Obrigatório se “bluesky” estiver no array platforms.
string
Nome da Página do Facebook codificado em URL. Por exemplo, “@newyorkgiants” ou “newyorkgiants”. O Facebook não permite contas pessoais.Obrigatório se “facebook” estiver no array platforms.
string
Handle do Instagram codificado em URL. Por exemplo: “@nygiants” ou “nygiants”. Observação: somente contas Business e Creator do Instagram podem ser retornadas.Obrigatório se “instagram” estiver no array platforms.
string
Vanity name da empresa (organização) no LinkedIn, como Linkedin ou linkedin-marketing-solutions.Você também pode consultar uma pessoa usando o ID de pessoa do LinkedIn obtido pelo endpoint history, ou seja, pessoas que curtiram uma publicação. Exemplo de ID: urn:li:person:Z_yXaxh_EtObrigatório se “linkedin” estiver no array platforms.
string
Handle do Twitter codificado em URL. Por exemplo: “@ayrshare” ou “ayrshare”.Obrigatório se “twitter” estiver no array platforms.
string
Nome de usuário do YouTube codificado em URL, ID do canal ou ID da playlist. Observe que IDs de canal normalmente começam com “UC” e IDs de playlist começam com “PL”. Por exemplo, envie o nome de usuário “MelissaEtheridgeVEVO” ou o ID do canal “UCpSUQewzOXg1F0zLmieKCqQ”.Você também pode usar o handle do YouTube encontrado na URL do YouTube. Por exemplo, o handle de https://www.youtube.com/@mkbhd é “@mkbhd”. Certifique-se de manter o símbolo @ para indicar o handle.Obrigatório se “youtube” estiver no array platforms.