{
  "info": {
    "name": "Datagma API",
    "description": "Official Postman collection for the Datagma B2B data enrichment API.\n\nBase URL: https://gateway.datagma.net/api/ingress/\n\nAuthentication: Add your API key as the `apiId` variable in your environment.\n\nDocs: https://datagmaapi.readme.io",
    "version": "1.0.0",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://gateway.datagma.net/api/ingress",
      "type": "string"
    },
    {
      "key": "apiId",
      "value": "YOUR_API_KEY",
      "description": "Your Datagma API key — get it at app.datagma.com/user-api",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Person & Company Enrichment",
      "item": [
        {
          "name": "Enrich Person (LinkedIn URL)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v2/full?apiId={{apiId}}&data=https%3A%2F%2Flinkedin.com%2Fin%2Fraphaelazot&companyPremium=true",
              "host": ["{{baseUrl}}"],
              "path": ["v2", "full"],
              "query": [
                {
                  "key": "apiId",
                  "value": "{{apiId}}",
                  "description": "Your Datagma API key"
                },
                {
                  "key": "data",
                  "value": "https%3A%2F%2Flinkedin.com%2Fin%2Fraphaelazot",
                  "description": "LinkedIn URL (URL-encoded)"
                },
                {
                  "key": "companyPremium",
                  "value": "true",
                  "description": "Include premium company data",
                  "disabled": false
                },
                {
                  "key": "companyFull",
                  "value": "true",
                  "description": "Include full company details",
                  "disabled": true
                },
                {
                  "key": "personFull",
                  "value": "true",
                  "description": "Include full person details",
                  "disabled": true
                },
                {
                  "key": "phoneFull",
                  "value": "true",
                  "description": "Include phone enrichment",
                  "disabled": true
                },
                {
                  "key": "whatsappCheck",
                  "value": "true",
                  "description": "Check if phone is on WhatsApp",
                  "disabled": true
                }
              ]
            },
            "description": "Enrich a person from their LinkedIn URL. Returns 50+ fields including email, company, job title, and more.\n\nCredits: 2 per match. No charge if no result."
          },
          "response": []
        },
        {
          "name": "Enrich Person (First + Last + Company)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v2/full?apiId={{apiId}}&firstName=Raphael&lastName=Azot&company=Datagma",
              "host": ["{{baseUrl}}"],
              "path": ["v2", "full"],
              "query": [
                {
                  "key": "apiId",
                  "value": "{{apiId}}"
                },
                {
                  "key": "firstName",
                  "value": "Raphael"
                },
                {
                  "key": "lastName",
                  "value": "Azot"
                },
                {
                  "key": "company",
                  "value": "Datagma",
                  "description": "Company name or domain"
                }
              ]
            },
            "description": "Enrich a person using first name, last name, and company."
          },
          "response": []
        },
        {
          "name": "Enrich Person (Professional Email)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v2/full?apiId={{apiId}}&data=raphael%40datagma.com",
              "host": ["{{baseUrl}}"],
              "path": ["v2", "full"],
              "query": [
                {
                  "key": "apiId",
                  "value": "{{apiId}}"
                },
                {
                  "key": "data",
                  "value": "raphael%40datagma.com",
                  "description": "Professional email (URL-encoded)"
                }
              ]
            },
            "description": "Enrich a person from their professional email address."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Email Finder",
      "item": [
        {
          "name": "Find Work Email (Full)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v6/findEmail?apiId={{apiId}}&fullName=Emilio%20Turco&company=Algolia&findEmailV2Step=3&findEmailV2Country=General",
              "host": ["{{baseUrl}}"],
              "path": ["v6", "findEmail"],
              "query": [
                {
                  "key": "apiId",
                  "value": "{{apiId}}"
                },
                {
                  "key": "fullName",
                  "value": "Emilio%20Turco",
                  "description": "Full name (URL-encoded)"
                },
                {
                  "key": "company",
                  "value": "Algolia",
                  "description": "Company name or domain"
                },
                {
                  "key": "linkedInSlug",
                  "value": "",
                  "description": "LinkedIn slug (alternative to company)",
                  "disabled": true
                },
                {
                  "key": "findEmailV2Step",
                  "value": "3",
                  "description": "3 = full search, 2 = domain only"
                },
                {
                  "key": "findEmailV2Country",
                  "value": "General",
                  "description": "Country context: 'France', 'General', etc."
                }
              ]
            },
            "description": "Find and verify a professional email address.\n\nReturns verified emails safe to send. 'Most Probable' (catchall) results are NOT billed.\n\nCredits: 1 per verified match, 0 if no result."
          },
          "response": []
        },
        {
          "name": "Find Work Email (Domain only)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v6/findEmail?apiId={{apiId}}&fullName=John%20Smith&company=example.com&findEmailV2Step=2&findEmailV2Country=General",
              "host": ["{{baseUrl}}"],
              "path": ["v6", "findEmail"],
              "query": [
                {
                  "key": "apiId",
                  "value": "{{apiId}}"
                },
                {
                  "key": "fullName",
                  "value": "John%20Smith"
                },
                {
                  "key": "company",
                  "value": "example.com"
                },
                {
                  "key": "findEmailV2Step",
                  "value": "2",
                  "description": "Domain-only search (faster, fewer credits)"
                },
                {
                  "key": "findEmailV2Country",
                  "value": "General"
                }
              ]
            },
            "description": "Faster email search using domain-only pattern matching (step=2)."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Phone Finder",
      "item": [
        {
          "name": "Search Phone (LinkedIn + Email)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/search?apiId={{apiId}}&username=https%3A%2F%2Flinkedin.com%2Fin%2Fraphaelazot&email=raphael%40datagma.com&minimumMatch=1",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "search"],
              "query": [
                {
                  "key": "apiId",
                  "value": "{{apiId}}"
                },
                {
                  "key": "username",
                  "value": "https%3A%2F%2Flinkedin.com%2Fin%2Fraphaelazot",
                  "description": "LinkedIn URL (URL-encoded)"
                },
                {
                  "key": "email",
                  "value": "raphael%40datagma.com",
                  "description": "Email address (URL-encoded)"
                },
                {
                  "key": "minimumMatch",
                  "value": "1",
                  "description": "Minimum confidence score (1-3)"
                },
                {
                  "key": "whatsappCheck",
                  "value": "true",
                  "description": "Check WhatsApp availability",
                  "disabled": true
                }
              ]
            },
            "description": "Find a phone number from a LinkedIn URL and/or email address. Combine both for best match rate (automatic waterfall).\n\nCredits: pay per match only. No charge if no result."
          },
          "response": []
        },
        {
          "name": "Search Phone (LinkedIn only)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/search?apiId={{apiId}}&username=https%3A%2F%2Flinkedin.com%2Fin%2Fraphaelazot&minimumMatch=1",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "search"],
              "query": [
                {
                  "key": "apiId",
                  "value": "{{apiId}}"
                },
                {
                  "key": "username",
                  "value": "https%3A%2F%2Flinkedin.com%2Fin%2Fraphaelazot",
                  "description": "LinkedIn URL (URL-encoded)"
                },
                {
                  "key": "minimumMatch",
                  "value": "1"
                }
              ]
            },
            "description": "Find a phone number from a LinkedIn URL only."
          },
          "response": []
        },
        {
          "name": "Search By Phone (Reverse Lookup)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/searchByPhone?apiId={{apiId}}&phone=%2B33612345678",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "searchByPhone"],
              "query": [
                {
                  "key": "apiId",
                  "value": "{{apiId}}"
                },
                {
                  "key": "phone",
                  "value": "%2B33612345678",
                  "description": "International phone number (URL-encoded, e.g. +33612345678)"
                }
              ]
            },
            "description": "Reverse phone lookup. Find person info (name, LinkedIn, company) from an international phone number."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Email Enrichment",
      "item": [
        {
          "name": "Search By Email",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/searchByEmail?apiId={{apiId}}&email=john.smith%40gmail.com",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "searchByEmail"],
              "query": [
                {
                  "key": "apiId",
                  "value": "{{apiId}}"
                },
                {
                  "key": "email",
                  "value": "john.smith%40gmail.com",
                  "description": "Personal email address (URL-encoded). For work emails, use /v2/full instead."
                }
              ]
            },
            "description": "Enrich a personal email address (outside EU). Returns profile information linked to the email.\n\nNote: For professional/work emails, use /v2/full instead."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Twitter / X",
      "item": [
        {
          "name": "Get Twitter by LinkedIn URL",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/getTwitter?apiId={{apiId}}&linkedin=https%3A%2F%2Flinkedin.com%2Fin%2Fraphaelazot",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "getTwitter"],
              "query": [
                {
                  "key": "apiId",
                  "value": "{{apiId}}"
                },
                {
                  "key": "linkedin",
                  "value": "https%3A%2F%2Flinkedin.com%2Fin%2Fraphaelazot",
                  "description": "LinkedIn URL (URL-encoded)"
                },
                {
                  "key": "username",
                  "value": "",
                  "description": "Twitter/X username (alternative input)",
                  "disabled": true
                }
              ]
            },
            "description": "Retrieve Twitter/X profile data from a LinkedIn URL."
          },
          "response": []
        },
        {
          "name": "Get Twitter by Email",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/getTwitterByEmail?apiId={{apiId}}&email=raphael%40datagma.com",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "getTwitterByEmail"],
              "query": [
                {
                  "key": "apiId",
                  "value": "{{apiId}}"
                },
                {
                  "key": "email",
                  "value": "raphael%40datagma.com",
                  "description": "Email address (URL-encoded)"
                }
              ]
            },
            "description": "Retrieve Twitter/X profile data from an email address."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Account",
      "item": [
        {
          "name": "Get Credit Balance",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/getCredit?apiId={{apiId}}",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "getCredit"],
              "query": [
                {
                  "key": "apiId",
                  "value": "{{apiId}}"
                }
              ]
            },
            "description": "Returns your remaining credit balance. Use this to monitor usage and avoid running out of credits."
          },
          "response": []
        }
      ]
    }
  ]
}