> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Datagma Full Enrichment: Inputs, Cost & CLI Example
> Run Datagma’s primary real-time person or company enrichment flow. Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=datagma_full_enrichment:{}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| ------------------------ | --------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `payload.data` | `string` | No | | You can submit a professional email address or a LinkedIn profile URL to get info about a person and his company. A successful person response costs two credits. You can also submit a company name, a website, or a Siren if you only want information about the company with this parameter. Note: If you don't have an email address or Linkedin Profile, and if you still want information about the person, you can use the couple Full Name + Company Name, see below) |
| `payload.companyKeyword` | `string` | No | | When you are looking for company informations using the data parameter. If you think several companies with the same name exist, you can submit us a keyword (like a part of the address, the name of the founder, or the industry), and our AI will pick the most probable company. |
| `payload.countryCode` | `string` | No | | Allow you to have accurate results. Indicate to Datagma crawler exactly where to search to reduce the risk of giving a namesake. |
| `payload.firstName` | `string` | No | | Replace the data parameter if you don't use it. (Must be used with lastName and company). |
| `payload.lastName` | `string` | No | | Replace the data parameter if you don't use it. (Must be used with firstName and company). |
| `payload.fullName` | `string` | No | | Instead of input firstname, lastname. You can input full name here |
| `payload.companyPremium` | `boolean` | No | `false` | To get the LinkedIn information about the enriched person's company. |
| `payload.companyFull` | `boolean` | No | `false` | To get financial information about the company of the enriched person. |
| `payload.companyFrench` | `boolean` | No | `false` | To get the information of the SIREN directory if the company is French. |
| `payload.personFull` | `boolean` | No | | To get the full profile of the person(education, past experiences...). |
| `payload.phoneFull` | `boolean` | No | | Cell phone number. Please use this endpoint to find phones only if you do not have your prospect's social profile or email. If you have them, please use the Search endpoint instead. |
| `payload.deepTraffic` | `boolean` | No | | Give you information about the website's traffic, (Traffic by country, similar websites, traffic by sources... ) |
| `payload.debug` | `boolean` | No | | By defaut Datagma filters what we consider junk results, thanks to the debug mode, you can access to this junk result |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "You can enrich an email address, a LinkedIn profile, or a full name with a company name to get info about the person and his company, Or you can send a company name, website, or SIREN number to get only company info.",
"properties": {
"data": {
"type": "string",
"description": "You can submit a professional email address or a LinkedIn profile URL to get info about a person and his company. A successful person response costs two credits. You can also submit a company name, a website, or a Siren if you only want information about the company with this parameter. Note: If you don't have an email address or Linkedin Profile, and if you still want information about the person, you can use the couple Full Name + Company Name, see below)"
},
"companyKeyword": {
"type": "string",
"description": "When you are looking for company informations using the data parameter. If you think several companies with the same name exist, you can submit us a keyword (like a part of the address, the name of the founder, or the industry), and our AI will pick the most probable company."
},
"countryCode": {
"type": "string",
"description": "Allow you to have accurate results. Indicate to Datagma crawler exactly where to search to reduce the risk of giving a namesake."
},
"firstName": {
"type": "string",
"description": "Replace the data parameter if you don't use it. (Must be used with lastName and company)."
},
"lastName": {
"type": "string",
"description": "Replace the data parameter if you don't use it. (Must be used with firstName and company)."
},
"fullName": {
"type": "string",
"description": "Instead of input firstname, lastname. You can input full name here"
},
"companyPremium": {
"type": "boolean",
"description": "To get the LinkedIn information about the enriched person's company.",
"default": false
},
"companyFull": {
"type": "boolean",
"description": "To get financial information about the company of the enriched person.",
"default": false
},
"companyFrench": {
"type": "boolean",
"description": "To get the information of the SIREN directory if the company is French.",
"default": false
},
"personFull": {
"type": "boolean",
"description": "To get the full profile of the person(education, past experiences...)."
},
"phoneFull": {
"type": "boolean",
"description": "Cell phone number. Please use this endpoint to find phones only if you do not have your prospect's social profile or email. If you have them, please use the Search endpoint instead."
},
"deepTraffic": {
"type": "boolean",
"description": "Give you information about the website's traffic, (Traffic by country, similar websites, traffic by sources... )"
},
"debug": {
"type": "boolean",
"description": "By defaut Datagma filters what we consider junk results, thanks to the debug mode, you can access to this junk result"
}
},
"required": [],
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes | | Provider response payload. |
| `result.meta` | `object` | No | | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Standard tool result payload.",
"properties": {
"data": {
"type": "object",
"description": "Provider response payload.",
"properties": {
"phone": {
"type": "object",
"properties": {
"workPhones": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"additionalProperties": false
}
},
"mobiles": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"email": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"email": {
"type": "string"
}
},
"additionalProperties": false
},
"person": {
"type": "object",
"properties": {
"basic": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"firstName": {
"type": "string"
},
"lastName": {
"type": "string"
},
"location": {
"type": "string"
},
"jobTitle": {
"type": "string"
},
"company": {
"type": "string"
},
"linkedInUrl": {
"type": "string"
},
"extractedRole": {
"type": "string"
},
"extractedSeniority": {
"type": "string"
},
"extractedGender": {
"type": "string"
},
"dateDeNaissanceFormate": {
"type": "string"
},
"age": {
"type": "string"
},
"personConfidenceScore": {
"type": "number",
"format": "float"
},
"employeeJobScore": {
"type": "number",
"format": "float"
},
"employeeCompanyScore": {
"type": "number",
"format": "float"
}
},
"additionalProperties": false
},
"data": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"position": {
"type": "string"
},
"currentCompany": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"link": {
"type": "string"
}
},
"additionalProperties": false
},
"avatar": {
"type": "string"
},
"about": {
"type": "string"
},
"city": {
"type": "string"
},
"educationsDetails": {
"type": "string"
},
"posts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"image": {
"type": "string"
},
"title": {
"type": "string"
},
"attribuion": {
"type": "string"
}
},
"additionalProperties": false
}
},
"experience": {
"type": "array",
"items": {
"type": "object",
"properties": {
"company": {
"type": "string"
},
"duration": {
"type": "string"
},
"positions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"meta": {
"type": "string"
}
},
"additionalProperties": false
}
},
"title": {
"type": "string"
},
"subtitle": {
"type": "string"
},
"location": {
"type": "string"
},
"description": {
"type": "string"
}
},
"additionalProperties": false
}
},
"education": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"subtitle": {
"type": "string"
},
"meta": {
"type": "string"
}
},
"additionalProperties": false
}
},
"certifications": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"subtitle": {
"type": "string"
},
"meta": {
"type": "string"
}
},
"additionalProperties": false
}
},
"courses": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"subtitle": {
"type": "string"
},
"meta": {
"type": "string"
}
},
"additionalProperties": false
}
},
"languages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"subtitle": {
"type": "string"
},
"meta": {
"type": "string"
}
},
"additionalProperties": false
}
},
"groups": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"subtitle": {
"type": "string"
},
"meta": {
"type": "string"
},
"img": {
"type": "string"
}
},
"additionalProperties": false
}
},
"input": {
"type": "object",
"properties": {
"url": {
"type": "string"
}
},
"additionalProperties": false
},
"from": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"company": {
"type": "object",
"properties": {
"basic": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"website": {
"type": "string"
},
"yearFounded": {
"type": "string"
},
"industry": {
"type": "string"
},
"size": {
"type": "integer",
"format": "int32"
},
"locality": {
"type": "string"
},
"region": {
"type": "string"
},
"country": {
"type": "string"
},
"linkedUrl": {
"type": "string"
}
},
"additionalProperties": false
},
"french": {
"type": "object",
"properties": {
"siren": {
"type": "string"
},
"nomEntreprise": {
"type": "string"
},
"codeNaf": {
"type": "string"
},
"libelleCodeNaf": {
"type": "string"
},
"domaineActivite": {
"type": "string"
},
"objetSocial": {
"type": "string"
},
"dateCreationFormate": {
"type": "string"
},
"entrepriseCessee": {
"type": "boolean"
},
"effectif": {
"type": "string"
},
"numeroTvaIntracommunautaire": {
"type": "string"
},
"siege": {
"type": "object",
"properties": {
"siret": {
"type": "string"
},
"adresseLigne1": {
"type": "string"
},
"codePostal": {
"type": "string"
},
"ville": {
"type": "string"
}
},
"additionalProperties": false
},
"representants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"nomComplet": {
"type": "string"
},
"dateDeNaissanceFormate": {
"type": "string"
},
"age": {
"type": "string",
"format": "int64"
},
"type": {
"type": "string"
},
"qualite": {
"type": "string"
}
},
"additionalProperties": false
}
},
"finances": {
"type": "array",
"items": {
"type": "object",
"properties": {
"annee": {
"type": "string",
"format": "int64"
},
"chiffreAffaires": {
"type": "string",
"format": "int64"
},
"chiffreAffairesPrettier": {
"type": "string"
},
"resultat": {
"type": "string",
"format": "int64"
},
"resultatPrettier": {
"type": "string"
},
"effectif": {
"type": "string",
"format": "int64"
},
"effectifPrettier": {
"type": "string"
},
"tauxCroissanceChiffreAffaires": {
"type": "number",
"format": "float"
},
"tauxCroissanceChiffreAffairesPrettier": {
"type": "string"
},
"effectifGrowthRate": {
"type": "number",
"format": "float"
},
"effectifGrowthRatePrettier": {
"type": "string"
},
"effectifEvolution": {
"type": "string",
"format": "int64"
},
"effectifEvolutionPrettier": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"full": {
"type": "object",
"properties": {
"properties": {
"type": "object",
"properties": {
"revenueRange": {
"type": "string"
},
"title": {
"type": "string"
},
"shortDescription": {
"type": "string"
},
"identifier": {
"type": "object",
"properties": {
"permalink": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"cards": {
"type": "object",
"properties": {
"fundingRoundsSummary": {
"type": "object",
"properties": {
"fundingTotal": {
"type": "object",
"properties": {
"valueUsd": {
"type": "number",
"format": "float"
},
"valueUsdPretty": {
"type": "string"
},
"valueUsdRoundup": {
"type": "string"
}
},
"additionalProperties": false
},
"lastFundingType": {
"type": "string"
},
"lastFundingAt": {
"type": "string"
},
"numFundingRounds": {
"type": "string",
"format": "int64"
}
},
"additionalProperties": false
},
"trafficRankHeadline": {
"type": "object",
"properties": {
"visitsLatestMonth": {
"type": "string",
"format": "int64"
},
"visitsLastestMonthPrettier": {
"type": "string"
},
"visitsMomPct": {
"type": "number",
"format": "float"
}
},
"additionalProperties": false
},
"spentSummary": {
"type": "object",
"properties": {
"siteItSpend": {
"type": "object",
"properties": {
"valueUsd": {
"type": "number",
"format": "float"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"overviewCompanyFields": {
"type": "object",
"properties": {
"companyType": {
"type": "string"
}
},
"additionalProperties": false
},
"overviewFields": {
"type": "object",
"properties": {
"revenueRange": {
"type": "number",
"format": "float"
},
"numEmployeesEnum": {
"type": "string"
},
"numEmployee": {
"type": "string"
},
"lastFundingType": {
"type": "string"
},
"operatingStatus": {
"type": "string"
},
"foundedOn": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"additionalProperties": false
},
"categories": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"additionalProperties": false
}
},
"legalName": {
"type": "string"
},
"fundingStage": {
"type": "string"
},
"locationGroupIdentifiers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"overviewFields2": {
"type": "object",
"properties": {
"website": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"additionalProperties": false
},
"linkedin": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"additionalProperties": false
},
"twitter": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"additionalProperties": false
},
"contactEmail": {
"type": "string"
},
"facebook": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"fundingRoundsList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"moneyRaised": {
"type": "object",
"properties": {
"value": {
"type": "string",
"format": "int64"
},
"currency": {
"type": "string"
},
"valueUsd": {
"type": "string",
"format": "int64"
},
"valueUsdPretty": {
"type": "string"
},
"valueUsdRoundup": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"trafficSummary": {
"type": "object",
"properties": {
"globalRank": {
"type": "string",
"format": "int64"
},
"globalRankPrettier": {
"type": "string"
},
"visitsLatestMonth": {
"type": "string",
"format": "int64"
},
"visitsLatestMonthPrettier": {
"type": "string"
}
},
"additionalProperties": false
},
"ipoSummary": {
"type": "object",
"properties": {
"stockLink": {
"type": "object",
"properties": {
"label": {
"type": "string"
}
},
"additionalProperties": false
},
"wentPublicOn": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"fullConfidenceScore": {
"type": "number",
"format": "float"
}
},
"additionalProperties": false
},
"premium": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"sphere": {
"type": "string"
},
"employeesAmountInLinkedin": {
"type": "string"
},
"about": {
"type": "string"
},
"headquaterAddr": {
"type": "string"
},
"headquaterAddrStreet": {
"type": "string"
},
"headquaterAddrPostalCode": {
"type": "string"
},
"headquaterAddrLocality": {
"type": "string"
},
"headquaterAddrRegion": {
"type": "string"
},
"headquaterAddrCountry": {
"type": "string"
},
"subsidiary": {
"type": "array",
"items": {
"type": "object",
"properties": {
"subsidiary": {
"type": "string"
},
"firstPart": {
"type": "string"
},
"secondpart": {
"type": "string"
}
},
"additionalProperties": false
}
},
"numberOfLocation": {
"type": "string"
},
"website": {
"type": "string"
},
"industries": {
"type": "string"
},
"companySize": {
"type": "string"
},
"headquarters": {
"type": "string"
},
"type": {
"type": "string"
},
"founded": {
"type": "string"
},
"specialties": {
"type": "string"
},
"specialtiesArr": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"additionalProperties": false
}
},
"input": {
"type": "object",
"properties": {
"url": {
"type": "string"
}
},
"additionalProperties": false
},
"companyId": {
"type": "string"
},
"locations": {
"type": "array",
"items": {
"type": "string"
}
},
"premiumConfidenceScore": {
"type": "number",
"format": "float"
}
},
"additionalProperties": false
},
"phone": {
"type": "object",
"properties": {
"formattedPhoneNumber": {
"type": "string"
},
"formattedAddress": {
"type": "string"
},
"geometry": {
"type": "object",
"properties": {
"location": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"format": "float"
},
"lng": {
"type": "number",
"format": "float"
}
},
"additionalProperties": false
},
"viewport": {
"type": "object",
"properties": {
"northeast": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"format": "float"
},
"lng": {
"type": "number",
"format": "float"
}
},
"additionalProperties": false
},
"southwest": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"format": "float"
},
"lng": {
"type": "number",
"format": "float"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"vicinity": {
"type": "string"
},
"score": {
"type": "number",
"format": "float"
}
},
"additionalProperties": false
},
"technologies": {
"type": "array",
"items": {
"type": "string"
}
},
"technologiesCategories": {
"type": "array",
"items": {
"type": "string"
}
},
"deepTraffic": {
"type": "object",
"properties": {
"addNetworks": {
"type": "object",
"properties": {
"count": {
"type": "string",
"format": "int64"
},
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"item": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"trafficSources": {
"type": "object",
"properties": {
"direct": {
"type": "number",
"format": "float"
},
"referrals": {
"type": "number",
"format": "float"
},
"search": {
"type": "number",
"format": "float"
},
"social": {
"type": "number",
"format": "float"
},
"mail": {
"type": "number",
"format": "float"
},
"paidReferrals": {
"type": "number",
"format": "float"
}
},
"additionalProperties": false
},
"category": {
"type": "string"
},
"similarSites": {
"type": "array",
"items": {
"type": "object",
"properties": {
"site": {
"type": "string"
},
"altImage": {
"type": "string"
},
"imageUrl": {
"type": "string"
},
"iconUrl": {
"type": "string"
},
"ellipsiseName": {
"type": "string"
},
"rank": {
"type": "string",
"format": "int64"
},
"isBlackListed": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"topCountryShares": {
"type": "array",
"items": {
"type": "object",
"properties": {
"item": {
"type": "array",
"items": {
"type": "number",
"format": "float"
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"employees": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"firstName": {
"type": "string"
},
"lastName": {
"type": "string"
},
"location": {
"type": "string"
},
"jobTitle": {
"type": "string"
},
"company": {
"type": "string"
},
"linkedInUrl": {
"type": "string"
},
"extractedRole": {
"type": "string"
},
"extractedSeniority": {
"type": "string"
},
"extractedGender": {
"type": "string"
},
"dateDeNaissanceFormate": {
"type": "string"
},
"age": {
"type": "string"
},
"personConfidenceScore": {
"type": "number",
"format": "float"
},
"employeeJobScore": {
"type": "number",
"format": "float"
},
"employeeCompanyScore": {
"type": "number",
"format": "float"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"emailV2": {
"type": "object",
"properties": {
"email": {
"type": "string"
},
"emailDomain": {
"type": "string"
},
"status": {
"type": "string"
},
"patterns": {
"type": "array",
"items": {
"type": "string"
}
},
"mxfound": {
"type": "boolean"
},
"smtpCheck": {
"type": "boolean"
},
"cachAll": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute datagma_full_enrichment --payload '{}' --json
```
### CLI flags
| Flag | Description |
| --------------------------- | --------------------------------------------------- |
| `--json` | Print machine-readable output. |
| `--wait` | Wait for terminal provider status when supported. |
| `--debug` | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS` | Max seconds to wait in wait mode. |
| `--poll-interval SECONDS` | Polling interval in seconds during wait mode. |
| `--timeout SECONDS` | Request timeout in seconds. |
| `--connect-timeout SECONDS` | Connection timeout in seconds. |
## Cost
* Pricing model: `provider_usage` (provider usage).
* Estimated Deepline credits: `0.14` per pricing unit.
* Billing mode: `post_deduct`.