Buscar leads

curl --request GET \
  --url https://api.g1.datacrazy.io/api/v1/leads \
  --header 'Authorization: Bearer <token>'

{
  "count": 100,
  "data": [
    {
      "id": "15b41959-b04d-4a99-b878-6e45fffa7633",
      "createdAt": "2025-06-11T18:31:25.203Z",
      "name": "Guilherme Gavazzoni",
      "image": "https://dc-qqqq2222pb.s3.amazonaws.com/0a7ac87c-2f50-46b5-9c39-80ffec53e633/1163f5c2-62f4-443f-a84f-9c223b05ae3b",
      "phone": "+55 (47) 991331190",
      "rawPhone": "5547991331190",
      "email": "[email protected]",
      "source": "Google ads",
      "company": "Apple",
      "taxId": "108.154.702-92",
      "site": "www.meulead.com.br",
      "instagram": "@guilhermegavazzoni",
      "address": {
        "zip": "88338-130",
        "address": "Avenida Brasil",
        "block": "Centro",
        "city": "Balneário Camboriú",
        "state": "SC",
        "country": "BR"
      },
      "tags": {
        "id": "849fefab-e697-4720-9303-e788c23790cc",
        "name": "IA",
        "color": "#DC2626",
        "description": "Leads IA",
        "createdAt": "2025-06-12T17:37:17.861Z"
      },
      "lists": [
        {
          "id": "5343afav-e697-4720-9303-e788c23711dd",
          "name": "ativos",
          "color": "#EB2626",
          "description": "lista de compradores recorrentes",
          "createdAt": "2025-06-12T17:37:17.861Z"
        },
        {
          "id": "f2b3c92d-3843-406f-a3e3-672d2d7d2a27",
          "name": "inativos",
          "color": "#EB2626",
          "description": "lista de compradores de baixa frequência",
          "createdAt": "2025-12-03T17:28:09:5361Z"
        }
      ],
      "contacts": [
        {
          "platform": "EMAIL",
          "contactId": "853b46db8ae664237d89dd6",
          "lastContactStatus": null
        },
        {
          "platform": "WHATSAPP",
          "contactId": "555491664460",
          "lastContactStatus": {
            "platform": "WHATSAPP",
            "contactId": "555491664460",
            "instanceId": "681bb0510fe99d126e7c6b7b",
            "isPending": true,
            "lastReceivedMessage": {
              "messageId": "684c13db8ae7797307d83cc3",
              "date": "2025-06-13T12:04:48.218Z",
              "errorCode": null
            },
            "lastSendedMessage": {
              "messageId": "684c13c28ae7797307d83bc4",
              "date": "2025-06-13T12:04:23.511Z",
              "errorCode": null
            }
          }
        }
      ],
      "metrics": {
        "purchaseCount": 1,
        "lastPurchaseDate": "2025-06-04T19:34:55.535Z",
        "averageTicket": 14040,
        "totalSpent": 21080,
        "openBusinessesCount": 4,
        "lostBusinessesCount": 1,
        "lostBusinessesTotalValue": 7800,
        "purchaseFrequency": 3
      },
      "attendant": {
        "userId": "86BshEbu5WY94ZOB8beUvk1y7tF2",
        "id": "6cc8c79c-a0c8-4293-a4a0-d7e730aff7c7",
        "name": "Joao da Silva",
        "email": "[email protected]",
        "phone": "554791331190",
        "image": "https://dc-qqqq2222pb.s3.amazonaws.com/d129a692-e5ab-42b3-b0e4-90ad9a12b068/b1d045df-3a26-4e54-8d3f-7df4df5e2f08"
      },
      "sourceReferral": {
        "sourceId": "2bc3d979-93a4-4e64-8903-5d9379d3de91",
        "sourceUrl": "https://example.com/artigo-de-origem",
        "ctwaId": "849fefab-e697-4720-9303-e788c23790cc"
      },
      "additionalFields": {
        "id": "<string>",
        "additionalField": "<string>",
        "value": "<string>",
        "createdAt": "2023-11-07T05:31:56Z"
      }
    }
  ]
}

GET

api

leads

Buscar leads

curl --request GET \
  --url https://api.g1.datacrazy.io/api/v1/leads \
  --header 'Authorization: Bearer <token>'

{
  "count": 100,
  "data": [
    {
      "id": "15b41959-b04d-4a99-b878-6e45fffa7633",
      "createdAt": "2025-06-11T18:31:25.203Z",
      "name": "Guilherme Gavazzoni",
      "image": "https://dc-qqqq2222pb.s3.amazonaws.com/0a7ac87c-2f50-46b5-9c39-80ffec53e633/1163f5c2-62f4-443f-a84f-9c223b05ae3b",
      "phone": "+55 (47) 991331190",
      "rawPhone": "5547991331190",
      "email": "[email protected]",
      "source": "Google ads",
      "company": "Apple",
      "taxId": "108.154.702-92",
      "site": "www.meulead.com.br",
      "instagram": "@guilhermegavazzoni",
      "address": {
        "zip": "88338-130",
        "address": "Avenida Brasil",
        "block": "Centro",
        "city": "Balneário Camboriú",
        "state": "SC",
        "country": "BR"
      },
      "tags": {
        "id": "849fefab-e697-4720-9303-e788c23790cc",
        "name": "IA",
        "color": "#DC2626",
        "description": "Leads IA",
        "createdAt": "2025-06-12T17:37:17.861Z"
      },
      "lists": [
        {
          "id": "5343afav-e697-4720-9303-e788c23711dd",
          "name": "ativos",
          "color": "#EB2626",
          "description": "lista de compradores recorrentes",
          "createdAt": "2025-06-12T17:37:17.861Z"
        },
        {
          "id": "f2b3c92d-3843-406f-a3e3-672d2d7d2a27",
          "name": "inativos",
          "color": "#EB2626",
          "description": "lista de compradores de baixa frequência",
          "createdAt": "2025-12-03T17:28:09:5361Z"
        }
      ],
      "contacts": [
        {
          "platform": "EMAIL",
          "contactId": "853b46db8ae664237d89dd6",
          "lastContactStatus": null
        },
        {
          "platform": "WHATSAPP",
          "contactId": "555491664460",
          "lastContactStatus": {
            "platform": "WHATSAPP",
            "contactId": "555491664460",
            "instanceId": "681bb0510fe99d126e7c6b7b",
            "isPending": true,
            "lastReceivedMessage": {
              "messageId": "684c13db8ae7797307d83cc3",
              "date": "2025-06-13T12:04:48.218Z",
              "errorCode": null
            },
            "lastSendedMessage": {
              "messageId": "684c13c28ae7797307d83bc4",
              "date": "2025-06-13T12:04:23.511Z",
              "errorCode": null
            }
          }
        }
      ],
      "metrics": {
        "purchaseCount": 1,
        "lastPurchaseDate": "2025-06-04T19:34:55.535Z",
        "averageTicket": 14040,
        "totalSpent": 21080,
        "openBusinessesCount": 4,
        "lostBusinessesCount": 1,
        "lostBusinessesTotalValue": 7800,
        "purchaseFrequency": 3
      },
      "attendant": {
        "userId": "86BshEbu5WY94ZOB8beUvk1y7tF2",
        "id": "6cc8c79c-a0c8-4293-a4a0-d7e730aff7c7",
        "name": "Joao da Silva",
        "email": "[email protected]",
        "phone": "554791331190",
        "image": "https://dc-qqqq2222pb.s3.amazonaws.com/d129a692-e5ab-42b3-b0e4-90ad9a12b068/b1d045df-3a26-4e54-8d3f-7df4df5e2f08"
      },
      "sourceReferral": {
        "sourceId": "2bc3d979-93a4-4e64-8903-5d9379d3de91",
        "sourceUrl": "https://example.com/artigo-de-origem",
        "ctwaId": "849fefab-e697-4720-9303-e788c23790cc"
      },
      "additionalFields": {
        "id": "<string>",
        "additionalField": "<string>",
        "value": "<string>",
        "createdAt": "2023-11-07T05:31:56Z"
      }
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

skip

number

take

number

string

complete

object

Show child attributes

complete.additionalFields

boolean

Indica se os campos adicionais devem ser incluídos na resposta

filter

object

Show child attributes

filter.tags

string

Lista de IDs de tags.

Este campo aceita uma lista de IDs separados por vírgula, com uma operação opcional definida no início da string.

Formato: <operação> <id1>,<id2>,<id3>

Operação (opcional): define como os IDs serão interpretados. Se omitida, a operação padrão é some. Pode ser:

some – pelo menos uma das tags.
every – todas as tags.
none – nenhuma das tags.

Example:

"every 849fefab-e697-4720-9303-e788c23790cc,9e008d34-86d2-49fd-90af-34a9f9b29896"

filter.stages

string

ID ou lista de IDs de tags.

Este campo aceita um ID ou uma lista de IDs de tags separados por vírgula, com uma operação opcional definida no início da string.

Formato: <operação> <id1>,<operação> <id2>,<operação> <id3>

Operação (opcional): define como os IDs serão interpretados. Se omitida, a operação padrão é some. Pode ser:

some – pelo menos uma das tags.
every – todas as tags.
none – nenhuma das tags.

Example:

"none 849fefab-e697-4720-9303-e788c23790cc,9e008d34-86d2-49fd-90af-34a9f9b29896"

filter.minLastPurchaseDate

string<date-time>

Filtrar clientes que fizeram alguma compra na data 'X' ou anterior

Formato (ISO 8601): YYYY-MM-DDTHH:mm:ss.sssZ

filter.maxLastPurchaseDate

string<date-time>

Filtrar clientes que fizeram alguma compra na data 'X' ou posterior

Formato (ISO 8601): YYYY-MM-DDTHH:mm:ss.sssZ

filter.productsInBusiness

number

Quantidade de produtos que há nos negócios do lead

Example:

"7"

filter.minBusinessesCount

number

Quantidade mínima de negócios atrelados ao lead

Example:

"3"

filter.maxBusinessesCount

number

Quantidade máxima de negócios atrelados ao lead

Example:

"9"

filter.lists

string

Lista de IDs de listas.

Este campo aceita uma lista de IDs separados por vírgula, com uma operação opcional definida no início da string.

Formato: <operação> <id1>,<id2>,<id3>

Operação (opcional): define como os IDs serão interpretados. Se omitida, a operação padrão é some. Pode ser:

some – pelo menos uma das listas.
every – todas as listas.
none – nenhuma das listas.

Example:

"every 849fefab-e697-4720-9303-e788c23790cc,9e008d34-86d2-49fd-90af-34a9f9b29896"

filter.hasMessages

boolean

Leads que já possuem alguma mensagem no CRM

Example:

"valores booleanos true ou false"

filter.notHasMessages

boolean

Leads que não possuem nenhuma mensagem no CRM

Example:

"valores booleanos true ou false"

filter.source

string

Lead por sua origem

Example:

"Google Ads"

filter.products

string

Lista de IDs de SKUs.

Este campo aceita uma lista de IDs separados por vírgula, com uma operação opcional definida no início da string.

Formato: <operação> <id1>,<id2>,<id3>

Operação (opcional): define como os IDs serão interpretados. Se omitida, a operação padrão é some. Pode ser:

some – pelo menos um dos SKUs.
every – todos os SKUs.
none – nenhum dos SKUs.

Example:

"none 849fefab-e697-4720-9303-e788c23790cc,9e008d34-86d2-49fd-90af-34a9f9b29896"

filter.attendant

string

ID de atendente.

Este campo aceita uma string referente ao ID do atendente.

Example:

"849fefab-e697-4720-9303-e788c23790cc"

filter.fields

string

Expressões de filtro em campos adicionais.

Formato: <idDoCampo> <operação> <valorDoCampo>

idDoCampo: ID do campo adicional. operação: tipo de filtro aplicado. Operações disponíveis:

contains – campo contém o valor.
eq – campo igual ao valor.
not – campo não contém o valor. valorDoCampo: conteúdo do campo adicional.

Example:

"6f236135-0c72-40d2-9ff5-18c983aeb02b contains texto do campo"

filter.createdAtGreaterOrEqual

string<date-time>

Data de criação do lead (maior ou igual). Exemplo: filtrar lead que foram criados na data 'X' ou em data posterior

Formato (ISO 8601): YYYY-MM-DDTHH:mm:ss.sssZ

filter.createdAtLessOrEqual

string<date-time>

Data de criação do lead (menor ou igual). Exemplo: filtrar lead que foram criados na data 'X' ou em data anterior

Formato (ISO 8601): YYYY-MM-DDTHH:mm:ss.sssZ

filter.address

string

Filtros de endereço.

Formato: <campo> <valorDoCampo>,<campo> <valorDoCampo>,<campo> <valorDoCampo>

Campo: nome do campo a ser consultado. Podem ser utilizados em conjunto conforme o formato acima. Campos disponíveis:

block – bairro
city – cidade
state – estado
country – país ValorDoCampo: conteúdo do campo.

Example:

"city São Pauo"

Response

200 - application/json

count

number

required

Example:

100

data

object[]

Show child attributes

data.id

string

Id do lead

Example:

"15b41959-b04d-4a99-b878-6e45fffa7633"

data.createdAt

string<date-time>

Data de criação do lead

Example:

"2025-06-11T18:31:25.203Z"

data.name

string

Nome do lead

Example:

"Guilherme Gavazzoni"

data.image

string

Url da Imagem do lead

Example:

"https://dc-qqqq2222pb.s3.amazonaws.com/0a7ac87c-2f50-46b5-9c39-80ffec53e633/1163f5c2-62f4-443f-a84f-9c223b05ae3b"

data.phone

string

Telefone do lead

Example:

"+55 (47) 991331190"

data.rawPhone

string

Telefone do lead (apenas números)

Example:

"5547991331190"

data.email

string

Email do lead

Example:

"[email protected]"

data.source

string

Origem do lead

Example:

"Google ads"

data.company

string

Empresa do lead

Example:

"Apple"

data.taxId

string

Documento de identificação

Example:

"108.154.702-92"

data.site

string

Site do lead

Example:

"www.meulead.com.br"

data.instagram

string

Instagram do lead

Example:

"@guilhermegavazzoni"

data.address

object

Endereço vinculado ao lead

Show child attributes

data.address.zip

string

Código postal do lead

data.address.address

string

Endereço do lead

data.address.block

string

Bairro do lead

data.address.city

string

Cidade do lead

data.address.state

string

Estado do lead

data.address.country

string

País do lead

Example:

{
  "zip": "88338-130",
  "address": "Avenida Brasil",
  "block": "Centro",
  "city": "Balneário Camboriú",
  "state": "SC",
  "country": "BR"
}

data.tags

object

ID das tags atreladas ao lead

Show child attributes

data.tags.id

string

ID da tag

Example:

"cb3e8d24-ccad-43d1-acd5-08580d9bc674"

data.tags.name

string

Nome da tag

Example:

"marketing orgânico"

data.tags.color

string

Cor da tag em hexadecimal

Example:

"#A78BFA"

data.tags.description

string

Descrição atribuída a tag

Example:

"Leads que vieram de campanhas internas"

data.tags.createdAt

string<date-time>

Data de cricão da tag

Example:

"2025-03-25T14:12:47.738Z"

Example:

{
  "id": "849fefab-e697-4720-9303-e788c23790cc",
  "name": "IA",
  "color": "#DC2626",
  "description": "Leads IA",
  "createdAt": "2025-06-12T17:37:17.861Z"
}

data.lists

string[]

Array de listas atreladas ao lead

Example:

[
  {
    "id": "5343afav-e697-4720-9303-e788c23711dd",
    "name": "ativos",
    "color": "#EB2626",
    "description": "lista de compradores recorrentes",
    "createdAt": "2025-06-12T17:37:17.861Z"
  },
  {
    "id": "f2b3c92d-3843-406f-a3e3-672d2d7d2a27",
    "name": "inativos",
    "color": "#EB2626",
    "description": "lista de compradores de baixa frequência",
    "createdAt": "2025-12-03T17:28:09:5361Z"
  }
]

data.contacts

object

Array de contatos atrelados ao lead

Example:

[
  {
    "platform": "EMAIL",
    "contactId": "853b46db8ae664237d89dd6",
    "lastContactStatus": null
  },
  {
    "platform": "WHATSAPP",
    "contactId": "555491664460",
    "lastContactStatus": {
      "platform": "WHATSAPP",
      "contactId": "555491664460",
      "instanceId": "681bb0510fe99d126e7c6b7b",
      "isPending": true,
      "lastReceivedMessage": {
        "messageId": "684c13db8ae7797307d83cc3",
        "date": "2025-06-13T12:04:48.218Z",
        "errorCode": null
      },
      "lastSendedMessage": {
        "messageId": "684c13c28ae7797307d83bc4",
        "date": "2025-06-13T12:04:23.511Z",
        "errorCode": null
      }
    }
  }
]

data.metrics

object

Métricas referentes ao lead

Show child attributes

data.metrics.purchaseCount

number

Quantidade de compras realizadas pelo lead

data.metrics.lastPurchaseDate

string<date-time>

Data da ultima compra realizada

data.metrics.averageTicket

number

Ticket médio

data.metrics.totalSpent

number

Total gasto

data.metrics.openBusinessesCount

number

Quantiade de negócios em aberto

data.metrics.lostBusinessesCount

number

Quantidade de negócios perdidos

data.metrics.lostBusinessesTotalValue

number

Valor total dos negócios perdidos

data.metrics.purchaseFrequency

number

Frequência de compra

Example:

{
  "purchaseCount": 1,
  "lastPurchaseDate": "2025-06-04T19:34:55.535Z",
  "averageTicket": 14040,
  "totalSpent": 21080,
  "openBusinessesCount": 4,
  "lostBusinessesCount": 1,
  "lostBusinessesTotalValue": 7800,
  "purchaseFrequency": 3
}

data.attendant

object

Atual atendente do lead

Show child attributes

data.attendant.userId

string

ID do usuário

Example:

"t9kn9mqPakdGG535GQK3hod8wzM2"

data.attendant.id

string

ID do usuário como atendente (ID do atendente)

Example:

"6807e48c25ece34f9f1ba7dd"

data.attendant.name

string

Nome do atendente

Example:

"Joao Silva"

data.attendant.email

string

Email do atendente

Example:

"[email protected]"

data.attendant.phone

string

Telefone do atendente

Example:

"5547991331190"

data.attendant.imageURL

string

Url da imagem do atendente

Example:

"https://dc-qqqq1111pb.s3.amazonaws.com/profiles/koQGLa8p68fNZiiSmE1tec2LHtc2_2025-05-24T00%3A27%3A23.486Z"

Example:

{
  "userId": "86BshEbu5WY94ZOB8beUvk1y7tF2",
  "id": "6cc8c79c-a0c8-4293-a4a0-d7e730aff7c7",
  "name": "Joao da Silva",
  "email": "[email protected]",
  "phone": "554791331190",
  "image": "https://dc-qqqq2222pb.s3.amazonaws.com/d129a692-e5ab-42b3-b0e4-90ad9a12b068/b1d045df-3a26-4e54-8d3f-7df4df5e2f08"
}

data.sourceReferral

object

Fonte de referencia do lead

Show child attributes

data.sourceReferral.sourceId

string

ID referente fonte

Example:

"2bc3d979-93a4-4e64-8903-5d9379d3de91"

data.sourceReferral.sourceUrl

string

Url referente fonte

Example:

"https://example.com/artigo-de-origem"

data.sourceReferral.ctwaId

string

CTWA referente (Click to WhatsApp ID)

Example:

"849fefab-e697-4720-9303-e788c23790cc"

data.additionalFields

object

Show child attributes

data.additionalFields.id

string

required

ID do valor do campo adicional

data.additionalFields.additionalField

string

required

Valor do campo adicional

data.additionalFields.value

string

required

Valor do campo adicional

data.additionalFields.createdAt

string<date-time>

required

Data de criação do valor do campo adicional

Limites de Requisições Criar lead

⌘I

Primeiros Passos

API Reference

Buscar leads

Authorizations

Query Parameters

Response