Referência da API

Visão geral

A API do SNSTracker permite gerenciar programaticamente feeds e canais de monitoramento. Você pode criar feeds (vídeos, posts etc.) e canais (contas, perfis), atualizá-los para obter os dados mais recentes e receber notificações em tempo real via webhooks.

Autenticação

Todas as solicitações da API exigem autenticação usando uma chave de API. Inclua sua chave de API no cabeçalho X-API-Key.

Como obter sua chave de API:

  1. Faça login no SNSTracker
  2. Vá para Configurações → Chaves de API
  3. Crie uma nova chave de API ou use uma existente
  4. Copie a chave de API (você só a verá uma vez ao criar)

Endpoints da API

1. Criar Feeds

Crie feeds de monitoramento enviando URLs de feeds (vídeos, posts etc.).

POST /api/v1/feeds

Solicitação

Cabeçalhos:

  • X-API-Key: Sua chave de API (obrigatório)
  • Content-Type: application/json

Corpo da Solicitação:

{
  "urls": [
    "https://www.tiktok.com/@user/video/1234567890",
    "https://www.instagram.com/p/ABC123/"
  ],
  "collectionId": "coll_abc123xyz"
}

Parâmetros:

  • urls (obrigatório): Array de URLs de feeds para monitorar. Máximo de 200 URLs por solicitação.
  • collectionId (opcional): ID da coleção onde os feeds serão adicionados. Se não for fornecido, a coleção padrão da sua equipe será usada.

Resposta

Resposta de Sucesso (200):

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": 2,
    "failed": 0,
    "total": 2,
    "results": [
      {
        "index": 0,
        "url": "https://www.tiktok.com/@user/video/1234567890",
        "platform": "tiktok",
        "feedId": "feed_abc123xyz",
        "success": true
      },
      {
        "index": 1,
        "url": "https://www.instagram.com/p/ABC123/",
        "platform": "instagram",
        "feedId": "feed_def456uvw",
        "success": true
      }
    ],
    "errors": [],
    "message": "Feeds criados com sucesso. Os dados serão atualizados em breve."
  }
}

Campos da Resposta:

  • success: Número de feeds criados com sucesso
  • failed: Número de falhas na criação de feeds
  • total: Número total de URLs fornecidas
  • results: Array de resultados para cada URL
    • index: Índice baseado em zero no array da solicitação
    • url: A URL validada e padronizada
    • platform: Plataforma detectada (tiktok, instagram, youtube etc.)
    • feedId: Identificador único do feed criado
    • success: Se o feed foi criado com sucesso
    • skipped: (opcional) Se o feed foi ignorado porque já existe
    • resumed: (opcional) Se um feed interrompido foi retomado
    • error: (opcional) Mensagem de erro se a criação falhar
  • errors: Array de erros para URLs com falha

Exemplo de Solicitação

curl -X POST https://snstracker.com/api/v1/feeds \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.tiktok.com/@user/video/1234567890"
    ]
  }'

2. Atualizar Feeds

Atualize feeds existentes para obter os dados mais recentes imediatamente. Apenas feeds com status "Pending" ou "Tracked" podem ser atualizados.

POST /api/v1/feeds/refresh

Solicitação

Cabeçalhos:

  • X-API-Key: Sua chave de API (obrigatório)
  • Content-Type: application/json

Corpo da Solicitação:

{
  "feedIds": ["feed_abc123xyz", "feed_def456uvw"]
}

Parâmetros:

  • feedIds (obrigatório): Array de IDs de feeds a atualizar

Resposta

Resposta de Sucesso (200):

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "feedIds": ["feed_abc123xyz", "feed_def456uvw"],
    "total": 2,
    "message": "2 feed(s) atualizados com sucesso"
  }
}

Campos da Resposta:

  • success: Se a operação de atualização foi bem-sucedida
  • feedIds: Array de IDs de feeds que foram atualizados
  • total: Número de feeds atualizados
  • message: Mensagem de sucesso

Exemplo de Solicitação

curl -X POST https://snstracker.com/api/v1/feeds/refresh \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "feedIds": ["feed_abc123xyz"]
  }'

3. Criar Canais

Crie canais de monitoramento enviando URLs de canais (perfis de conta etc.).

Channel pricing note: Xiaohongshu channel tasks are priced separately from the default channel task price and currently cost 10 credits per successful request.

POST /api/v1/channels

Solicitação

Cabeçalhos:

  • X-API-Key: Sua chave de API (obrigatório)
  • Content-Type: application/json

Corpo da Solicitação:

{
  "urls": [
    "https://www.tiktok.com/@username",
    "https://www.instagram.com/username/"
  ],
  "collectionId": "coll_abc123xyz"
}

Parâmetros:

  • urls (obrigatório): Array de URLs de canais para monitorar. Máximo de 5 URLs por solicitação.
  • collectionId (opcional): ID da coleção onde os canais serão adicionados. Se não for fornecido, a coleção padrão da sua equipe será usada.

Resposta

Resposta de Sucesso (200):

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": 2,
    "failed": 0,
    "total": 2,
    "results": [
      {
        "index": 0,
        "url": "https://www.tiktok.com/@username",
        "platform": "tiktok",
        "channelId": "channel_abc123xyz",
        "success": true
      },
      {
        "index": 1,
        "url": "https://www.instagram.com/username/",
        "platform": "instagram",
        "channelId": "channel_def456uvw",
        "success": true
      }
    ],
    "errors": [],
    "message": "Canais criados com sucesso. Os dados serão atualizados em breve."
  }
}

Campos da Resposta:

  • success: Número de canais criados com sucesso
  • failed: Número de falhas na criação de canais
  • total: Número total de URLs fornecidas
  • results: Array de resultados para cada URL
    • index: Índice baseado em zero no array da solicitação
    • url: A URL validada e padronizada
    • platform: Plataforma detectada (tiktok, instagram, youtube etc.)
    • channelId: Identificador único do canal criado
    • success: Se o canal foi criado com sucesso
    • skipped: (opcional) Se o canal foi ignorado porque já existe
    • resumed: (opcional) Se um canal interrompido foi retomado
    • error: (opcional) Mensagem de erro se a criação falhar
  • errors: Array de erros para URLs com falha

Exemplo de Solicitação

curl -X POST https://snstracker.com/api/v1/channels \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.tiktok.com/@username"
    ]
  }'

4. Atualizar Canais

Atualize canais existentes para obter os dados mais recentes imediatamente. Apenas canais com status "Pending" ou "Tracked" podem ser atualizados.

Channel pricing note: Xiaohongshu channel tasks are priced separately from the default channel task price and currently cost 10 credits per successful request.

POST /api/v1/channels/refresh

Solicitação

Cabeçalhos:

  • X-API-Key: Sua chave de API (obrigatório)
  • Content-Type: application/json

Corpo da Solicitação:

{
  "channelIds": ["channel_abc123xyz", "channel_def456uvw"]
}

Parâmetros:

  • channelIds (obrigatório): Array de IDs de canais a atualizar

Resposta

Resposta de Sucesso (200):

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "channelIds": ["channel_abc123xyz", "channel_def456uvw"],
    "total": 2,
    "message": "2 canal(is) atualizados com sucesso"
  }
}

Campos da Resposta:

  • success: Se a operação de atualização foi bem-sucedida
  • channelIds: Array de IDs de canais que foram atualizados
  • total: Número de canais atualizados
  • message: Mensagem de sucesso

Exemplo de Solicitação

curl -X POST https://snstracker.com/api/v1/channels/refresh \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "channelIds": ["channel_abc123xyz"]
  }'

5. Sincronizar Feed

Sincronize dados do feed diretamente do serviço scrapy. Este endpoint busca os dados mais recentes do feed imediatamente e consome créditos após a sincronização bem-sucedida. Todos os membros e chaves de API da equipe compartilham um único limite entre todos os endpoints de sincronização. O limite compartilhado é 1 para Starter ou sem assinatura válida, 5 para Standard e 10 para Premium.

⚠️ Observação Importante: Este endpoint de sincronização é independente e NÃO integra com a plataforma web. As operações de sincronização irão:

  • NÃO criar ou atualizar registros de feeds no painel web
  • NÃO aparecer na sua lista de feeds ou coleções
  • NÃO disparar webhooks ou notificações
  • APENAS retornar os dados buscados diretamente na resposta da API

Este endpoint é projetado para recuperação única de dados via API. Para criar feeds de monitoramento persistentes que apareçam na plataforma web, use o endpoint Criar Feeds.

POST /api/v1/feeds/sync

Solicitação

Cabeçalhos:

  • X-API-Key: Sua chave de API (obrigatório)
  • Content-Type: application/json

Corpo da Solicitação:

{
  "url": "https://www.tiktok.com/@user/video/1234567890"
}

Parâmetros:

  • url (obrigatório): URL do feed a sincronizar. Deve ser uma string válida e não vazia.

Resposta

Resposta de Sucesso (200):

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "url": "https://www.tiktok.com/@user/video/1234567890",
    "feedInfo": {
      "feed_id": "1234567890",
      "platform": 1,
      "platform_name": "tiktok",
      "url": "https://www.tiktok.com/@user/video/1234567890",
      "views": 1000000,
      "likes": 200000,
      "comments": 1000,
      "shares": 2000,
      "bookmarks": 200,
      "engagement": 512000,
      "description": "Descrição do vídeo",
      "hashtags": ["tag1", "tag2"],
      "publish_at": 1234567890
    }
  }
}

Campos da Resposta:

  • success: Se a operação de sincronização foi bem-sucedida
  • url: A URL do feed sincronizado
  • feedInfo: Informações completas do feed incluindo métricas, descrição, hashtags etc.

Respostas de Erro:

  • 429 Too Many Requests: O limite compartilhado da equipe foi atingido. A solicitação não entra em fila.
  • 400 Bad Request: Créditos insuficientes ou URL inválida

Exemplo de Solicitação

curl -X POST https://snstracker.com/api/v1/feeds/sync \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.tiktok.com/@user/video/1234567890"
  }'

6. Sincronizar Canal

Sincronize dados do canal diretamente do serviço scrapy. Este endpoint busca os dados mais recentes do canal imediatamente e consome créditos após a sincronização bem-sucedida. Todos os membros e chaves de API da equipe compartilham um único limite entre todos os endpoints de sincronização. O limite compartilhado é 1 para Starter ou sem assinatura válida, 5 para Standard e 10 para Premium.

Channel pricing note: Xiaohongshu channel tasks are priced separately from the default channel task price and currently cost 10 credits per successful request.

⚠️ Observação Importante: Este endpoint de sincronização é independente e NÃO integra com a plataforma web. As operações de sincronização irão:

  • NÃO criar ou atualizar registros de canais no painel web
  • NÃO aparecer na sua lista de canais ou coleções
  • NÃO disparar webhooks ou notificações
  • APENAS retornar os dados buscados diretamente na resposta da API

Este endpoint é projetado para recuperação única de dados via API. Para criar canais de monitoramento persistentes que apareçam na plataforma web, use o endpoint Criar Canais.

POST /api/v1/channels/sync

Solicitação

Cabeçalhos:

  • X-API-Key: Sua chave de API (obrigatório)
  • Content-Type: application/json

Corpo da Solicitação:

{
  "url": "https://www.tiktok.com/@username"
}

Parâmetros:

  • url (obrigatório): URL do canal a sincronizar. Deve ser uma string válida e não vazia.

Resposta

Resposta de Sucesso (200):

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "url": "https://www.tiktok.com/@username",
    "channelInfo": {
      "id": "1234567890",
      "platform": 1,
      "platform_name": "tiktok",
      "username": "username",
      "nickname": "User Name",
      "description": "Descrição do canal",
      "followers": 1000000,
      "followings": 2000,
      "likes": 200000000,
      "total_count": 1000,
      "track_count": 1000,
      "status": 1
    }
  }
}

Campos da Resposta:

  • success: Se a operação de sincronização foi bem-sucedida
  • url: A URL do canal sincronizado
  • channelInfo: Informações completas do canal incluindo métricas, descrição etc.

Respostas de Erro:

  • 429 Too Many Requests: O limite compartilhado da equipe foi atingido. A solicitação não entra em fila.
  • 400 Bad Request: Créditos insuficientes ou URL inválida

Exemplo de Solicitação

curl -X POST https://snstracker.com/api/v1/channels/sync \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.tiktok.com/@username"
  }'

7. Sincronizar conteúdo do canal

Retorna uma página com no máximo 12 itens por solicitação para Instagram e Reels, sem paginação automática. instagram inclui imagens, vídeos e carrosséis; reels retorna vídeos Reels.

POST /api/v1/channels/feeds/sync
X-API-Key: your-api-key
Content-Type: application/json

Request and pagination

{
  "platform": "instagram",
  "channel_name": "instagram"
}
  • count é um inteiro positivo opcional que indica a quantidade desejada de itens nesta página, sem valor padrão. Os limites dependem da plataforma: Instagram e Reels retornam no máximo 12 itens por solicitação, podendo retornar menos. Se omitido, usa o tamanho de página padrão da plataforma.
  • Omita cursor na primeira página. Na próxima, envie o next_cursor anterior sem alterações e mantenha platform e channel_name. No fim: has_more=false, next_cursor=null.
{
  "platform": "instagram",
  "channel_name": "instagram",
  "cursor": "previous-next-cursor"
}

Cada página obtida com sucesso custa 10 créditos, incluindo páginas vazias. Apenas solicitações com falha são gratuitas; o saldo inicial deve ser de pelo menos 10 créditos. Compartilha o limite de concorrência da equipe com as outras APIs de sincronização e não cria registros no painel.

Response example (placeholder cursor) — reels, lunacut.edit, count=1

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "platform": "reels",
    "channel_name": "lunacut.edit",
    "channel_url": "https://www.instagram.com/lunacut.edit/",
    "requested_count": 1,
    "returned_count": 1,
    "has_more": true,
    "next_cursor": "cursor-from-response",
    "items": [
      {
        "feed_id": "4009169989985582972",
        "platform": 5,
        "platform_name": "reels",
        "type": "video",
        "url": "https://www.instagram.com/reel/Dejbt1JPz98/",
        "author_username": "lunacut.edit",
        "publish_at": 1792150387,
        "duration": 70.077,
        "view_count": 310475
      }
    ]
  }
}

platform and channel_name are required. channel_name is the username, not the display name; leading @ is accepted and dots are preserved. requested_count is null when count is omitted; returned_count equals items.length. Unknown metrics/timestamps are null. Posts may lack timestamps and carousel details. items uses the existing feed fields, including video_url, image_urls and cover_url; the example shows only selected fields. publish_at is Unix seconds and duration is seconds. Upstream order is preserved, without a most-popular sorting option; deduplicate across pages by feed_id. Empty pages can still have a next cursor; a carousel counts as one post.

As métricas de items, como visualizações (view_count), curtidas (like_count), salvamentos (bookmark_count) e comentários (comment_count), dependem da plataforma e dos dados de sua lista de conteúdo. Algumas podem estar indisponíveis. Métricas indisponíveis são retornadas como null, o que não significa zero.

Para consultar métricas ausentes da lista, chame POST /api/v1/feeds/sync separadamente, usando a url do item no campo url do corpo da solicitação. Essa consulta de detalhes é cobrada separadamente conforme as regras desse endpoint. Os resultados dependem dos dados fornecidos pela plataforma; não há garantia de recuperar todas as métricas ausentes.

HTTP: 400 invalid input/cursor or insufficient initial credits; 401 invalid API key; 403 disabled team or inaccessible channel; 402 insufficient credits at settlement; 429 team concurrency limit (Retry-After: 1); 502 upstream/invalid page; 503 service unavailable; 504 timeout.

8. Obter informações adicionais do perfil

POST /api/v1/channels/about/sync

Apenas Instagram e Reels. Mesmo url obrigatório de /api/v1/channels/sync: https://www.instagram.com/lunacut.edit/ ou https://www.instagram.com/lunacut.edit/reels/. Não exige platform, count nem cursor. Publicações e outras plataformas não são aceitas.

curl -X POST https://snstracker.com/api/v1/channels/about/sync \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.instagram.com/lunacut.edit/"}'

Cada solicitação bem-sucedida custa 80 créditos, mesmo com campos null. Erros não são cobrados; saldo mínimo de 80 créditos antes da consulta. Concorrência compartilhada entre as APIs síncronas da equipe: Starter/sem assinatura ativa 1, Standard 5, Premium 10. Não cria registros nem envia webhooks.

Resposta de exemplo; a disponibilidade depende das informações públicas da conta.

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "url": "https://www.instagram.com/lunacut.edit/",
    "channelAbout": {
      "platform": 6,
      "platform_name": "instagram",
      "username": "lunacut.edit",
      "channel_url": "https://www.instagram.com/lunacut.edit/",
      "country": "Brazil",
      "country_visible": true,
      "date_joined": "2020-05",
      "date_joined_text": "May 2020"
    }
  }
}

country: país/região público, apenas se country_visible=true, não localização IP em tempo real. country_visible: visibilidade ou null se desconhecida. date_joined: mês de criação (YYYY-MM) ou null se ausente/não reconhecido. date_joined_text: texto original ou null. Não inclui bio, seguidores nem nomes anteriores.

400 / 401 / 402 / 403 / 429 (Retry-After: 1) / 502 / 503 / 504.

Integração de Webhook

O SNSTracker oferece suporte a webhooks para receber notificações em tempo real quando o conteúdo monitorado atinge os limites configurados. Você pode configurar webhooks para receber notificações sobre:

  • Atualizações de feeds: Quando visualizações, engajamento (curtidas + comentários + compartilhamentos) aumentam de acordo com seu limite
  • Atualizações de canais: Quando seguidores, seguindo ou curtidas aumentam de acordo com seu limite

Configurando Webhooks

  1. Configure os destinos de webhook nas configurações de Coleções
  2. Ative as notificações na configuração da Coleção
  3. Defina limites para as métricas que você deseja monitorar

Para instruções detalhadas de configuração de webhooks, consulte o Guia de Configuração de Webhook.

Respostas de Erro

Todos os endpoints podem retornar as seguintes respostas de erro:

401 Não Autorizado - Chave de API ausente

{
  "code": -1,
  "message": "O cabeçalho X-API-Key é obrigatório"
}

401 Não Autorizado - Chave de API inválida

{
  "code": -1,
  "message": "Chave de API inválida"
}

400 Requisição Inválida - Entrada inválida

{
  "code": -1,
  "message": "Solicitação inválida: urls deve ser um array"
}

400 Requisição Inválida - URLs em excesso (Criar Feeds)

{
  "code": -1,
  "message": "Máximo de 200 URLs permitidas por solicitação"
}

400 Requisição Inválida - URLs em excesso (Criar Canais)

{
  "code": -1,
  "message": "Máximo de 5 URLs permitidas por solicitação"
}

400 Requisição Inválida - Créditos insuficientes

{
  "code": -1,
  "message": "Créditos insuficientes. Necessário: 10, Disponível: 5"
}

429 Too Many Requests - Concorrência de sincronização da equipe

{
  "code": -1,
  "message": "Maximum concurrent sync requests (1) reached for this team. Currently active: 1. Wait for a request to complete, or contact official support to increase the limit."
}

403 Proibido - Coleção inválida

{
  "code": -1,
  "message": "Coleção não encontrada ou não pertence à sua equipe"
}

404 Não Encontrado

{
  "code": -1,
  "message": "Nenhum feed encontrado"
}

ou

{
  "code": -1,
  "message": "Nenhum canal encontrado"
}

Exemplos de Uso

Exemplo em Python - Criar Feeds

import requests

url = "https://snstracker.com/api/v1/feeds"
headers = {
    "X-API-Key": "your-api-key-here",
    "Content-Type": "application/json"
}
data = {
    "urls": [
        "https://www.tiktok.com/@user/video/1234567890",
        "https://www.instagram.com/p/ABC123/"
    ]
}

response = requests.post(url, json=data, headers=headers)
result = response.json()

if result["code"] == 0:
    print(f"Feeds criados com sucesso: {result['data']['success']}")
    for feed in result["data"]["results"]:
        print(f"  - {feed['url']}: {feed['feedId']}")
else:
    print(f"Erro: {result['message']}")

Exemplo em JavaScript - Atualizar Feeds

const response = await fetch('https://snstracker.com/api/v1/feeds/refresh', {
  method: 'POST',
  headers: {
    'X-API-Key': 'your-api-key-here',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    feedIds: ['feed_abc123xyz', 'feed_def456uvw'],
  }),
});

const result = await response.json();

if (result.code === 0) {
  console.log(`Feeds atualizados com sucesso: ${result.data.total}`);
  result.data.feedIds.forEach((feedId) => {
    console.log(`  - ${feedId}`);
  });
} else {
  console.error(`Erro: ${result.message}`);
}

Observações Importantes

  1. Validação de URLs: Todas as URLs são validadas automaticamente antes da criação. URLs inválidas serão rejeitadas.

  2. Itens Duplicados: Se um item com a mesma URL já existir na coleção:

    • Se estiver ativo, será ignorado (marcado com skipped: true)
    • Se estiver interrompido, será retomado (marcado com resumed: true)
  3. Coleta de Dados: Após a criação bem-sucedida, os itens são enfileirados para coleta de dados. Os dados estarão disponíveis pouco tempo após a criação.

  4. Status de Atualização: Apenas itens com status "Pending" ou "Tracked" podem ser atualizados. Itens com outros status serão filtrados.

  5. Créditos: Certifique-se de ter créditos suficientes antes de fazer solicitações. As operações de sincronização consomem créditos imediatamente após a recuperação bem-sucedida dos dados. Xiaohongshu channel tasks are priced separately and currently cost 10 credits per successful request. /api/v1/channels/feeds/sync: Cada página obtida com sucesso custa 10 créditos, incluindo páginas vazias. Apenas solicitações com falha são gratuitas; o saldo inicial deve ser de pelo menos 10 créditos. Compartilha o limite de concorrência da equipe com as outras APIs de sincronização e não cria registros no painel. /api/v1/channels/about/sync: Cada solicitação bem-sucedida custa 80 créditos, mesmo com campos null. Erros não são cobrados; saldo mínimo de 80 créditos antes da consulta. Concorrência compartilhada entre as APIs síncronas da equipe: Starter/sem assinatura ativa 1, Standard 5, Premium 10. Não cria registros nem envia webhooks.

  6. Concorrência de sincronização da equipe (/api/v1/feeds/sync + /api/v1/channels/sync + /api/v1/channels/feeds/sync + /api/v1/channels/about/sync): Todos os membros e chaves de API da equipe compartilham um único limite entre todos os endpoints de sincronização. O limite compartilhado é 1 para Starter ou sem assinatura válida, 5 para Standard e 10 para Premium. O limite acompanha a assinatura atualmente válida; uma configuração específica da equipe definida pelo suporte oficial tem prioridade. Para aumentar o limite da equipe, entre em contato com o suporte oficial.

  7. Sincronizar vs Criar: Os endpoints de sincronização (/api/v1/feeds/sync e /api/v1/channels/sync + /api/v1/channels/feeds/sync + /api/v1/channels/about/sync) são independentes e NÃO integram com a plataforma web. Eles apenas retornam dados na resposta da API e não criam registros no painel. Para criar itens de monitoramento persistentes que apareçam na plataforma web, use os endpoints de Criação (/api/v1/feeds e /api/v1/channels) em vez disso.

  8. Novas tentativas: Após um 429, aguarde uma solicitação ativa terminar e tente novamente com intervalos crescentes, respeitando Retry-After. Após um 503, tente novamente mais tarde.

  9. Plataformas Compatíveis: TikTok, Instagram, YouTube e outras principais plataformas de mídia social.

Solução de Problemas

Problema: "O cabeçalho X-API-Key é obrigatório"
Solução: Certifique-se de incluir o cabeçalho X-API-Key na sua solicitação.

Problema: "Chave de API inválida"
Solução: Verifique se sua chave de API está correta. Você pode criar uma nova em Configurações → Chaves de API.

Problema: "Máximo de URLs permitidas por solicitação"
Solução: Divida suas URLs em várias solicitações. Feeds permitem até 200 URLs, canais permitem até 5 URLs por solicitação.

Problema: "Nenhuma coleção encontrada"
Solução: Crie uma coleção primeiro no painel ou especifique um ID de coleção existente.

Problema: "Créditos insuficientes"
Solução: Compre mais créditos ou verifique seu plano de assinatura.

Problema: "Nenhum item atualizável encontrado"
Solução: Apenas itens com status "Pending" ou "Tracked" podem ser atualizados. Verifique o status dos seus itens.

Problema: Algumas URLs falham na validação
Solução: Verifique o array errors na resposta para mensagens de erro específicas. Certifique-se de que as URLs são de plataformas compatíveis e estão publicamente acessíveis.