Fênix Social API

Integre nossa plataforma de marketing digital diretamente no seu sistema. Crie pedidos, consulte status e gerencie saldo programaticamente.

URL base: https://fenixsocial.site/api/public-api
Todos os endpoints usam essa URL base com o parâmetro action.

Autenticação

Todas as requisições precisam de uma chave de API. Gere a sua no painel em Configurações → API.

Passe a chave em toda requisição via header ou query param:

Via header (recomendado)

Authorization: Bearer fsx_sua_chave_aqui

Via query param

https://fenixsocial.site/api/public-api?action=balance&key=fsx_sua_chave_aqui

Erros

Quando algo dá errado, a API retorna um objeto com o campo error:

{"error": "Saldo insuficiente. Disponível: R$ 5.00. Necessário: R$ 10.00"}

Código	Significado
200	Sucesso
400	Parâmetros inválidos ou saldo insuficiente
401	Chave de API inválida ou ausente
404	Serviço ou pedido não encontrado
500	Erro interno — entre em contato com o suporte

Listar serviços

GET ?action=services

Retorna todos os serviços disponíveis com o preço já calculado para a sua conta (com desconto aplicado se houver).

Resposta

[
  {
    "service": "1234",
    "name": "Instagram Seguidores Brasileiros",
    "category": "Instagram Followers [Brazil]",
    "type": "seguidores",
    "rate": 2.50,
    "min": 100,
    "max": 10000,
    "refill": true
  },
  ...
]

Campo	Descrição
service	ID do serviço (use no action=add)
name	Nome do serviço
rate	Preço por 1000 unidades em BRL
min / max	Quantidade mínima e máxima por pedido
refill	Se o serviço tem reposição automática

Consultar saldo

GET ?action=balance

Retorna o saldo disponível na carteira da sua conta.

Resposta

{
  "balance": "47.50",
  "currency": "BRL"
}

Criar pedido

POST ?action=add

Cria um novo pedido. O valor é debitado automaticamente do saldo da sua carteira.

Parâmetros (body JSON)

Parâmetro	Tipo	Descrição
action	string	"add"
service	string	ID do serviço (veja action=services)
link	string	Link do perfil ou postagem
quantity	number	Quantidade desejada
comments	string	(opcional) Comentários separados por linha

Exemplo de requisição

{
  "action": "add",
  "service": "1234",
  "link": "https://instagram.com/seuperfil",
  "quantity": 500
}

Resposta

{
  "order": "#00042",
  "status": "executando",
  "charge": "1.25",
  "currency": "BRL"
}

⚠️ Atenção: O perfil ou publicação deve estar público. Pedidos com perfis privados não são reembolsados.

Status do pedido

GET ?action=status&order=NUMERO

Consulta o status atual de um pedido pelo número gerado no momento da criação.

Parâmetro	Descrição
order	Número do pedido (ex: #00042)

Resposta

{
  "order": "#00042",
  "status": "executando",
  "charge": "1.25",
  "start_count": 1200,
  "remains": 300,
  "currency": "BRL"
}

Status	Significado
executando	Pedido em andamento
concluido	Pedido finalizado com sucesso
aguardando_pagamento	Aguardando confirmação de pagamento
cancelado	Pedido cancelado
erro_fornecedor	Erro ao processar — entre em contato com o suporte

Exemplos — cURL

Listar serviços

curl "https://fenixsocial.site/api/public-api?action=services" \
  -H "Authorization: Bearer fsx_sua_chave_aqui"

Criar pedido

curl -X POST "https://fenixsocial.site/api/public-api?action=add" \
  -H "Authorization: Bearer fsx_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{"action":"add","service":"1234","link":"https://instagram.com/seuperfil","quantity":500}'

Exemplos — JavaScript

const API_KEY = 'fsx_sua_chave_aqui';
const BASE = 'https://fenixsocial.site/api/public-api';
const headers = { 'Authorization': `Bearer ${API_KEY}`, 'Content-Type': 'application/json' };

// Listar serviços
const services = await fetch(`${BASE}?action=services`, { headers }).then(r => r.json());

// Criar pedido
const order = await fetch(`${BASE}?action=add`, {
  method: 'POST',
  headers,
  body: JSON.stringify({ action: 'add', service: '1234', link: 'https://instagram.com/perfil', quantity: 500 })
}).then(r => r.json());

console.log(order); // { order: '#00042', status: 'executando', charge: '1.25', currency: 'BRL' }

// Consultar status
const status = await fetch(`${BASE}?action=status&order=${order.order}`, { headers }).then(r => r.json());

Exemplos — Python

import requests

API_KEY = 'fsx_sua_chave_aqui'
BASE = 'https://fenixsocial.site/api/public-api'
HEADERS = {'Authorization': f'Bearer {API_KEY}', 'Content-Type': 'application/json'}

# Listar serviços
services = requests.get(f'{BASE}?action=services', headers=HEADERS).json()

# Criar pedido
order = requests.post(f'{BASE}?action=add', headers=HEADERS, json={
    'action': 'add',
    'service': '1234',
    'link': 'https://instagram.com/seuperfil',
    'quantity': 500
}).json()

print(order)  # {'order': '#00042', 'status': 'executando', 'charge': '1.25', 'currency': 'BRL'}

# Consultar status
status = requests.get(f'{BASE}?action=status&order={order["order"]}', headers=HEADERS).json()

Precisa de ajuda com a integração?

Falar com o suporte