Listar Agentes de Instagram

Recupera uma lista paginada de agentes de Instagram.

GET /external/v1/instagram-agents

Autenticacao

Requer chave de API com permissao instagram_agents:read.

Parametros de Query

Parametro	Tipo	Padrao	Descricao
status	string	-	Filtrar por status do agente
page	number	1	Numero da pagina
limit	number	50	Itens por pagina (max 100)

Resposta

{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Fitness Influencers SP",
      "description": "Collect fitness influencer profiles in São Paulo",
      "search_niche": "fitness",
      "search_location": "São Paulo",
      "status": "active",
      "total_profiles_found": 85,
      "total_limit": 200,
      "created_at": "2026-02-10T08:00:00Z",
      "updated_at": "2026-03-20T14:22:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 5,
    "total_pages": 1,
    "has_next": false,
    "has_prev": false
  }
}

Exemplo

cURL

curl --request GET \
  --url "https://app.getraze.com/external/v1/instagram-agents?status=active" \
  --header "X-API-Key: YOUR_API_KEY"

JavaScript

const response = await fetch(
  'https://app.getraze.com/external/v1/instagram-agents',
  {
    headers: { 'X-API-Key': 'YOUR_API_KEY' }
  }
);
const data = await response.json();

Python

import requests

response = requests.get(
    'https://app.getraze.com/external/v1/instagram-agents',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
data = response.json()

Erros

Status	Codigo	Descricao
401	MISSING_API_KEY	Nenhuma chave de API fornecida
401	INVALID_API_KEY	Chave de API invalida
403	INSUFFICIENT_PERMISSIONS	Sem permissao instagram_agents:read