GET
https://api.realoficial.com.br/api/v1
/
projects
curl -X GET "https://api.realoficial.com.br/api/v1/projects?page=1&per_page=20" \
  -H "Authorization: Bearer seu_token_aqui" \
  -H "Content-Type: application/json"
{
  "data": [
    {
      "id": "01k3ab12yqtsyrzjb0fveqy5zx",
      "title": "Podcast Episodio 42 - Entrevista Exclusiva",
      "url": "https://www.youtube.com/watch?v=abc123",
      "status": "face_analysis_done",
      "goal": "shorts",
      "video_layout": "single",
      "aspect_ratio": "vertical",
      "clip_duration": "60",
      "start_time": 0,
      "end_time": 3600,
      "created_at": "2025-01-24T10:30:00.000000Z",
      "thumbnail_url": "https://img.youtube.com/vi/abc123/maxresdefault.jpg",
      "metadata": {
        "title": "Podcast Episodio 42 - Entrevista Exclusiva",
        "duration": "1:45:30",
        "channel_title": "Meu Canal",
        "views": 15420
      }
    },
    {
      "id": "01k3cd34yqtsyrzjb0fveqy6ab",
      "title": "Aula de Marketing Digital",
      "url": "https://www.youtube.com/watch?v=xyz789",
      "status": "transcribing",
      "goal": "shorts",
      "video_layout": "split",
      "aspect_ratio": "vertical",
      "clip_duration": "90",
      "start_time": 600,
      "end_time": 4200,
      "created_at": "2025-01-23T15:20:00.000000Z",
      "thumbnail_url": "https://img.youtube.com/vi/xyz789/maxresdefault.jpg",
      "metadata": {
        "title": "Aula de Marketing Digital",
        "duration": "2:10:15",
        "channel_title": "Meu Canal"
      }
    }
  ],
  "links": {
    "first": "https://api.realoficial.com.br/api/v1/projects?page=1",
    "last": "https://api.realoficial.com.br/api/v1/projects?page=5",
    "prev": null,
    "next": "https://api.realoficial.com.br/api/v1/projects?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 5,
    "per_page": 20,
    "to": 20,
    "total": 87
  }
}

Endpoint

GET https://api.realoficial.com.br/api/v1/projects
Este endpoint requer autenticacao via Bearer Token.

Query Parameters

page
integer
Numero da pagina (padrao: 1)
per_page
integer
Quantidade de itens por pagina (1-100, padrao: 10)

Resposta de Sucesso

data
array
Lista de projetos
Links de navegacao da paginacao
meta
object
Metadados da paginacao
curl -X GET "https://api.realoficial.com.br/api/v1/projects?page=1&per_page=20" \
  -H "Authorization: Bearer seu_token_aqui" \
  -H "Content-Type: application/json"
{
  "data": [
    {
      "id": "01k3ab12yqtsyrzjb0fveqy5zx",
      "title": "Podcast Episodio 42 - Entrevista Exclusiva",
      "url": "https://www.youtube.com/watch?v=abc123",
      "status": "face_analysis_done",
      "goal": "shorts",
      "video_layout": "single",
      "aspect_ratio": "vertical",
      "clip_duration": "60",
      "start_time": 0,
      "end_time": 3600,
      "created_at": "2025-01-24T10:30:00.000000Z",
      "thumbnail_url": "https://img.youtube.com/vi/abc123/maxresdefault.jpg",
      "metadata": {
        "title": "Podcast Episodio 42 - Entrevista Exclusiva",
        "duration": "1:45:30",
        "channel_title": "Meu Canal",
        "views": 15420
      }
    },
    {
      "id": "01k3cd34yqtsyrzjb0fveqy6ab",
      "title": "Aula de Marketing Digital",
      "url": "https://www.youtube.com/watch?v=xyz789",
      "status": "transcribing",
      "goal": "shorts",
      "video_layout": "split",
      "aspect_ratio": "vertical",
      "clip_duration": "90",
      "start_time": 600,
      "end_time": 4200,
      "created_at": "2025-01-23T15:20:00.000000Z",
      "thumbnail_url": "https://img.youtube.com/vi/xyz789/maxresdefault.jpg",
      "metadata": {
        "title": "Aula de Marketing Digital",
        "duration": "2:10:15",
        "channel_title": "Meu Canal"
      }
    }
  ],
  "links": {
    "first": "https://api.realoficial.com.br/api/v1/projects?page=1",
    "last": "https://api.realoficial.com.br/api/v1/projects?page=5",
    "prev": null,
    "next": "https://api.realoficial.com.br/api/v1/projects?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 5,
    "per_page": 20,
    "to": 20,
    "total": 87
  }
}

Status dos Projetos

Em Processamento

  • pending - Aguardando
  • downloading - Baixando
  • transcribing - Transcrevendo
  • transcribed - Transcrito
  • shorts_created - Cortes criados

Concluido

  • face_analysis_done - Pronto para uso
  • refunded - Reembolsado

Filtrando por Status

Para filtrar projetos prontos, verifique o campo status:
const readyProjects = projects.filter(p => p.status === 'face_analysis_done');
const processingProjects = projects.filter(p =>
  ['pending', 'downloading', 'transcribing'].includes(p.status)
);