Adicionar Perfil ao Agente de Instagram

Adiciona um novo perfil de Instagram a um agente existente. Util para integracoes com Extensao do Chrome e scrapers personalizados.

POST /external/v1/instagram-agents/:id/profiles

Autenticacao

Requer chave de API com permissao instagram_agents:write.

Parametros de Caminho

Parametro	Tipo	Descricao
id	uuid	ID do Agente de Instagram

Corpo da Requisicao

Campo	Tipo	Obrigatorio	Descricao
username	string	Sim	Nome de usuario do Instagram
display_name	string	Nao	Nome de exibicao
profile_url	string	Nao	URL do perfil no Instagram
bio	string	Nao	Biografia do perfil
followers_count	number	Nao	Numero de seguidores
following_count	number	Nao	Numero de seguindo
posts_count	number	Nao	Numero de publicacoes
external_url	string	Nao	Link externo da bio
extracted_contacts	object	Nao	Informacoes de contato extraidas

Objeto extracted_contacts

Campo	Tipo	Descricao
emails	string[]	Enderecos de e-mail encontrados
phones	string[]	Numeros de telefone encontrados
websites	string[]	URLs de websites encontrados

Resposta

{
  "success": true,
  "data": {
    "profile": {
      "username": "johndoe_fitness",
      "display_name": "John Doe",
      "profile_url": "https://instagram.com/johndoe_fitness",
      "bio": "Fitness coach | DM for programs | johndoe@email.com",
      "followers_count": 15000,
      "following_count": 800,
      "posts_count": 342,
      "external_url": "https://johndoefitness.com",
      "extracted_contacts": {
        "emails": ["johndoe@email.com"],
        "phones": [],
        "websites": ["https://johndoefitness.com"]
      },
      "source": "chrome_extension",
      "added_at": "2026-03-20T14:22:00Z"
    },
    "agent": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Fitness Influencers SP",
      "total_profiles_found": 86
    }
  },
  "message": "Profile added to Instagram agent successfully"
}

Exemplo

cURL

curl --request POST \
  --url "https://app.getraze.com/external/v1/instagram-agents/AGENT_ID/profiles" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "username": "johndoe_fitness",
    "display_name": "John Doe",
    "bio": "Fitness coach | DM for programs",
    "followers_count": 15000,
    "following_count": 800,
    "posts_count": 342,
    "external_url": "https://johndoefitness.com",
    "extracted_contacts": {
      "emails": ["johndoe@email.com"],
      "websites": ["https://johndoefitness.com"]
    }
  }'

JavaScript

const response = await fetch(
  `https://app.getraze.com/external/v1/instagram-agents/${agentId}/profiles`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      username: 'johndoe_fitness',
      display_name: 'John Doe',
      bio: 'Fitness coach | DM for programs',
      followers_count: 15000,
      extracted_contacts: {
        emails: ['johndoe@email.com']
      }
    })
  }
);
const data = await response.json();

Python

import requests

response = requests.post(
    f'https://app.getraze.com/external/v1/instagram-agents/{agent_id}/profiles',
    headers={'X-API-Key': 'YOUR_API_KEY'},
    json={
        'username': 'johndoe_fitness',
        'display_name': 'John Doe',
        'bio': 'Fitness coach | DM for programs',
        'followers_count': 15000,
        'extracted_contacts': {
            'emails': ['johndoe@email.com']
        }
    }
)
data = response.json()

Erros

Status	Codigo	Descricao
400	VALIDATION_ERROR	Campos obrigatorios ausentes (username)
401	MISSING_API_KEY	Nenhuma chave de API fornecida
403	INSUFFICIENT_PERMISSIONS	Sem permissao instagram_agents:write
404	NOT_FOUND	Agente de Instagram nao encontrado
409	DUPLICATE_ERROR	Perfil ja existe neste agente