A API de Dados da X Media oferece aos desenvolvedores uma maneira direta de coletar dados públicos da X para painéis, pesquisas de conteúdo, análises de criadores, ferramentas de moderação e pipelines de automação.
Esta API foca em três casos de uso de alto valor:
1) Resolver um nome de usuário em informações de perfil.
2) Navegar pela linha do tempo de mídia de um usuário com paginação baseada em cursor.
3) Recuperar detalhes completos de tweet a partir de um ID de tweet ou uma URL completa da X.
Os endpoints são construídos para consumo de API em produção com validação clara de consultas, envoltório de resposta previsível e um modelo de autenticação leve.
A autenticação usa um único cabeçalho secreto em ambientes não de desenvolvimento, facilitando a integração a partir de serviços de backend, funções serverless e automações sem código.
Se você está desenvolvendo produtos de escuta social, fluxos de trabalho de inteligência de criadores, ferramentas de crescimento ou pipelines de enriquecimento de conteúdo, esta API é projetada para reduzir o tempo de integração enquanto mantém o comportamento dos endpoints consistente.
[PROPOSTA DE VALOR PRINCIPAL]
- Integração rápida com apenas parâmetros de consulta e um cabeçalho de autenticação.
- Projetada para cargas de trabalho operacionais: busca de perfil, tráfego de mídia e inspeção de tweet.
- Funciona bem para ETL, painéis de BI, ferramentas de criadores e inteligência de leads.
- Estrutura REST limpa adequada para consumidores do RapidAPI.
[URL BASE E NOTAS DE VERSIONAMENTO]
Endpoints da X cobertos nesta lista:
- /user/info
- /user/media
- /tweet/details
[NOTAS GERAIS DE CONTRATO DE SOLICITAÇÃO/RESPOSTA]
Envoltório de sucesso:
- As respostas da API retornam a carga útil dentro do campo "data".
Envoltório de erro:
- Erros da API retornam o campo "error".
- Exceções de validação e HTTP podem incluir "errorDetails" quando disponível.
Comportamento comum de status entre endpoints:
- 200: Solicitação bem-sucedida.
- 400: A validação falhou para os parâmetros de consulta.
- 403: A autenticação falhou.
- 500: Falha de upstream ou erro de processamento interno.
IMPORTANTE:
Esta lista intencionalmente evita exemplos de carga útil fixa para o objeto de dados aninhado porque os dados de fontes sociais upstream podem evoluir ao longo do tempo. O contrato estável é o envoltório e o comportamento dos parâmetros documentados abaixo.
Use este endpoint para resolver um identificador público X em informações de perfil que podem alimentar cartões de conta, pesquisas de identidade, painéis de criador e pipelines de enriquecimento
Este endpoint é ideal quando você precisa de uma pesquisa de conta leve antes de realizar uma análise mais profunda de linha do tempo ou nível de tweet
Obter Informações do Perfil do Usuário - Recursos do endpoint
| Objeto | Descrição |
|---|---|
username |
[Obrigatório] username of an user |
{"data":{"id":"1360509398041378817","name":"Defense Intelligence","username":"DI313_","createdAt":1613205701,"avatarUrl":"https://pbs.twimg.com/profile_images/1773964459205181440/KJTgBai3.jpg","isBlueVerified":true,"bioDescription":"Covering International Affairs, Monitoring Threat Matrix, National Security, Intelligence, Militancy and tracking politics.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/1360509398041378817/1754337330","followersCount":339166,"followingCount":3761,"statusesCount":30413,"mediaCount":13292}}
curl --location --request GET 'https://zylalabs.com/api/12396/x+media+data+api/23441/get+user+profile+info?username=Required' --header 'Authorization: Bearer YOUR_API_KEY'
Use este ponto de extremidade para buscar dados de linha do tempo focados em mídia para um usuário específico do X. É adequado para ingestão de feeds, monitoramento de tendências, trabalhos de arquivo e fluxos de rastreamento histórico
O ponto de extremidade suporta paginação baseada em cursor, para que os clientes possam iterar sobre grandes linhas do tempo de forma segura em várias solicitações
Obter Linha do Tempo do Usuário - Recursos do endpoint
| Objeto | Descrição |
|---|---|
userId |
[Obrigatório] id of the user |
cursor |
Opcional cursor for pagination |
{"data":{"dataItems":[{"id":"2045874068763632017","title":"","createdAt":1776609363,"totalMediaCount":1,"statistics":{"likeCount":188966,"commentCount":10423,"retweetCount":13521,"viewCount":16003821,"quoteCount":2725},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"2045874002250416128","isVideo":true,"downloadUrl":"https://video.twimg.com/amplify_video/2045874002250416128/vid/avc1/720x1280/Jai7sCeUH1ZrVWFD.mp4?tag=21"}],"quoted":null},{"id":"2044788684223066396","title":"","createdAt":1776350587,"totalMediaCount":1,"statistics":{"likeCount":10336,"commentCount":601,"retweetCount":859,"viewCount":493525,"quoteCount":87},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"2044788615935664128","isVideo":true,"downloadUrl":"https://video.twimg.com/amplify_video/2044788615935664128/vid/avc1/1280x720/ghkmXyJBW5eLztD_.mp4?tag=21"}],"quoted":null},{"id":"2043744899678515256","title":"","createdAt":1776101729,"totalMediaCount":1,"statistics":{"likeCount":23855,"commentCount":1071,"retweetCount":1494,"viewCount":1084509,"quoteCount":197},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"2043744897640083458","isVideo":false,"downloadUrl":"https://pbs.twimg.com/media/HFzXJ_tasAIL1wZ.jpg?format=jpg&name=large"}],"quoted":null},{"id":"2039372675211301259","title":"Let’s go!","createdAt":1775059310,"totalMediaCount":1,"statistics":{"likeCount":14651,"commentCount":911,"retweetCount":914,"viewCount":338954,"quoteCount":94},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"2039372673055424512","isVideo":false,"downloadUrl":"https://pbs.twimg.com/media/HE1OpB4bgAA31rJ.jpg?format=jpg&name=large"}],"quoted":null},{"id":"2020861883524247807","title":"","createdAt":1770645993,"totalMediaCount":1,"statistics":{"likeCount":23941,"commentCount":3470,"retweetCount":1403,"viewCount":7524170,"quoteCount":976},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"2020861879552499712","isVideo":false,"downloadUrl":"https://pbs.twimg.com/media/HAuLLCba4AAB2kT.jpg?format=jpg&name=large"}],"quoted":null},{"id":"1991987664766328990","title":"The Blue Moon MK1 flight vehicle that will land near Shackleton crater. We’ll soon be doing fully integrated checkout tests. At over 26 feet tall (8 meters), it’s smaller than our MK2 human lander but larger than the historic Apollo lander.","createdAt":1763761843,"totalMediaCount":1,"statistics":{"likeCount":12434,"commentCount":3739,"retweetCount":1603,"viewCount":1261663,"quoteCount":314},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"1991987659888009216","isVideo":false,"downloadUrl":"https://pbs.twimg.com/media/G6T2OQCWIAAjsE_.jpg?format=jpg&name=large"}],"quoted":null},{"id":"1990806387837055153","title":"","createdAt":1763480204,"totalMediaCount":1,"statistics":{"likeCount":9880,"commentCount":1395,"retweetCount":814,"viewCount":555858,"quoteCount":96},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"1990806383357489152","isVideo":false,"downloadUrl":"https://pbs.twimg.com/media/G6DD26CacAAZntT.jpg?format=jpg&name=large"}],"quoted":null},{"id":"1990796256751575547","title":"","createdAt":1763477789,"totalMediaCount":1,"statistics":{"likeCount":29743,"commentCount":2242,"retweetCount":2684,"viewCount":1362228,"quoteCount":392},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"1990796247893225479","isVideo":false,"downloadUrl":"https://pbs.twimg.com/media/G6C6o8fbMAclS71.jpg?format=jpg&name=large"}],"quoted":null},{"id":"1989856098409758793","title":"","createdAt":1763253638,"totalMediaCount":1,"statistics":{"likeCount":9333,"commentCount":1753,"retweetCount":871,"viewCount":1255635,"quoteCount":150},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"1989856028654268416","isVideo":true,"downloadUrl":"https://video.twimg.com/amplify_video/1989856028654268416/vid/avc1/1280x720/V3cSqVDIC-s4Tk1F.mp4?tag=21"}],"quoted":null},{"id":"1989704582025679295","title":"","createdAt":1763217513,"totalMediaCount":1,"statistics":{"likeCount":20674,"commentCount":1419,"retweetCount":1750,"viewCount":1671579,"quoteCount":393},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"1989704579362217984","isVideo":false,"downloadUrl":"https://pbs.twimg.com/media/G5zZxeTaYAAogOw.jpg?format=jpg&name=large"}],"quoted":null}],"pagination":{"hasNextPage":true,"nextCursor":"DAABCgABHGWxkQF___0KAAIbnNnGg5uRvwgAAwAAAAIAAA"}}}
curl --location --request GET 'https://zylalabs.com/api/12396/x+media+data+api/23442/get+user+media+timeline?userId=15506669' --header 'Authorization: Bearer YOUR_API_KEY'
Use este endpoint para normalizar consultas de tweet a partir de entradas mistas. Seu cliente pode enviar diretamente um ID de tweet ou uma URL completa de post do X, e a API resolve o identificador interno do tweet antes de buscar dados detalhados.
Este endpoint é útil para pipelines de ingestão onde os usuários colam links, ou para sistemas que armazenam apenas IDs de tweet.
Obter detalhes do Tweet - Recursos do endpoint
| Objeto | Descrição |
|---|---|
idOrUrl |
[Obrigatório] id or url of the tweet |
{"data":{"id":"2045309037848272993","title":"Tesla engineering redesigned lithium refining from physics first principles","createdAt":1776474649,"totalMediaCount":0,"statistics":{"likeCount":107713,"commentCount":3560,"retweetCount":14328,"viewCount":31523263,"quoteCount":350},"author":{"id":"44196397","name":"Elon Musk","username":"elonmusk","createdAt":1243973549,"avatarUrl":"https://pbs.twimg.com/profile_images/2035314704307081216/71U1ftM3.jpg","isBlueVerified":true,"bioDescription":"https://t.co/dDtDyVssfm","profileBannerUrl":"https://pbs.twimg.com/profile_banners/44196397/1774145451","followersCount":238604221,"followingCount":1315,"statusesCount":101597,"mediaCount":4456},"mediaList":[],"quoted":{"id":"2045303851482546505","title":"Our Lithium Refinery is designed to have a much lower carbon footprint than traditional hard rock refineries\n\n– Acid-free refining helps produce a safe coproduct\n– Water is recycled throughout production, with every drop treated & cleaned on site\n– Designed to close the loop for","createdAt":1776473412,"totalMediaCount":1,"statistics":{"likeCount":19470,"commentCount":613,"retweetCount":2627,"viewCount":30877306,"quoteCount":239},"author":{"id":"1679769205938311169","name":"Tesla North America","username":"tesla_na","createdAt":1689323193,"avatarUrl":"https://pbs.twimg.com/profile_images/1681000114607857665/FLyxuLUB.jpg","isBlueVerified":true,"bioDescription":"Building a world of amazing abundance","profileBannerUrl":"https://pbs.twimg.com/profile_banners/1679769205938311169/1689616932","followersCount":110959,"followingCount":20,"statusesCount":941,"mediaCount":229},"mediaList":[{"id":"2045302933437526016","isVideo":true,"downloadUrl":"https://video.twimg.com/amplify_video/2045302933437526016/vid/avc1/3840x2026/IEblQjFEFbwcuwQv.mp4?tag=21"}],"quoted":null}}}
curl --location --request GET 'https://zylalabs.com/api/12396/x+media+data+api/23443/get+tweet+details?idOrUrl=https://x.com/elonmusk/status/2045309037848272993' --header 'Authorization: Bearer YOUR_API_KEY'
| Cabeçalho | Descrição |
|---|---|
Authorization
|
[Obrigatório] Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito. |
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
A API retorna vários tipos de dados: o endpoint de Informações do Perfil do Usuário fornece detalhes do usuário como ID, nome, nome de usuário, biografia e contagem de seguidores. O endpoint da Linha do Tempo de Mídia do Usuário retorna postagens de mídia com estatísticas como curtidas, comentários e retweets. O endpoint de Detalhes do Tweet oferece informações abrangentes sobre o tweet, incluindo detalhes do autor e mídia associada ao tweet
Os campos-chave incluem "id", "nome", "nome de usuário", "descriçãoBio" e "contagemDeSeguidores" para perfis de usuário. Para linhas do tempo de mídia, campos como "contagemTotalDeMídia", "estatísticas" e "listaDeMídia" são essenciais. O endpoint de Detalhes do Tweet apresenta os detalhes "título", "criadoEm" e "autor", fornecendo uma visão completa do tweet
Os dados de resposta estão estruturados dentro de um campo "data" que contém as informações relevantes Cada resposta de endpoint inclui atributos específicos relacionados aos dados solicitados garantindo um formato consistente Os erros estão encapsulados em um campo "error" fornecendo clareza sobre os problemas encontrados durante as solicitações
Cada endpoint aceita parâmetros específicos o endpoint de Informações do Perfil do Usuário requer um nome de usuário enquanto o endpoint da Linha do Tempo de Mídia do Usuário precisa de um ID de usuário O endpoint de Detalhes do Tweet pode aceitar um ID de tweet ou uma URL completa do X Esses parâmetros permitem que os usuários personalizem suas solicitações para a recuperação precisa de dados
Os casos de uso típicos incluem a criação de painéis para análise de redes sociais, realização de pesquisa de conteúdo e desenvolvimento de ferramentas de inteligência para criadores A API também é útil para tarefas de moderação e pipelines de automação permitindo um manuseio eficiente de dados para várias aplicações
A precisão dos dados é mantida através do acesso direto às informações da conta pública X garantindo atualizações em tempo real O design da API inclui verificações de validação para os parâmetros da consulta o que ajuda a prevenir erros e garante que os dados retornados sejam confiáveis e atualizados
Os usuários podem aproveitar os dados retornados para análise e relatórios integrando-os em painéis de BI ou processos ETL A resposta estruturada permite fácil análise e manipulação permitindo que os desenvolvedores construam aplicações que requerem insights em tempo real dos dados públicos X
Os usuários devem verificar o campo "data" na resposta Se estiver vazio ou nulo indica que nenhum resultado foi encontrado Implementar tratamento de erro para códigos de status como 400 ou 500 pode ajudar a gerenciar resultados inesperados garantindo um comportamento robusto da aplicação mesmo com dados incompletos
Nível de serviço:
100%
Tempo de resposta:
1.626ms
Nível de serviço:
100%
Tempo de resposta:
17ms
Nível de serviço:
100%
Tempo de resposta:
1.704ms
Nível de serviço:
100%
Tempo de resposta:
10.167ms
Nível de serviço:
100%
Tempo de resposta:
1.135ms
Nível de serviço:
100%
Tempo de resposta:
511ms
Nível de serviço:
100%
Tempo de resposta:
1.932ms
Nível de serviço:
100%
Tempo de resposta:
2.819ms
Nível de serviço:
100%
Tempo de resposta:
3.116ms
Nível de serviço:
100%
Tempo de resposta:
2.795ms