# Datagma

Datagma delivers data intelligence and analytics, assisting companies in discovering market insights, tracking competitive metrics, and strategizing growth opportunities

- **Category:** analytics
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 8
- **Triggers:** 0
- **Slug:** `DATAGMA`
- **Version:** 20260312_00

## Tools

### Detect Job Change

**Slug:** `DATAGMA_DETECT_JOB_CHANGE`

Tool to detect if a contact changed jobs. Use when verifying a contact’s current employment details by email.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address of the contact to check; must be a valid email format |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Enrich Person or Company

**Slug:** `DATAGMA_ENRICH_PERSON_OR_COMPANY`

Enrich person or company data using LinkedIn URLs, emails, domains, or names. Returns enriched data including: contact information, LinkedIn profiles, company details, work experience, education, phone numbers (with phoneFull), and company metrics. Input types: LinkedIn profile URL (~100% success), email (~60% success), name+company (~90% success), company domain/name, or SIREN number (French companies).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Primary input: LinkedIn URL, domain, email, company name, or SIREN number. |
| `debug` | boolean | No | Include lower-confidence matches and detailed scoring information when true. |
| `fullName` | string | No | Full name of person (alternative to firstName/lastName; required when phoneFull=true). |
| `lastName` | string | No | Last name of the person (use with firstName and company for name-based enrichment). |
| `firstName` | string | No | First name of the person (use with lastName and company for name-based enrichment). |
| `phoneFull` | boolean | No | Search for cell phone numbers when true (requires fullName or firstName+lastName). |
| `personFull` | boolean | No | Include full LinkedIn profile (education, experience, skills, posts) when true. |
| `companyFull` | boolean | No | Include extended company data (funding, traffic, technologies, growth metrics) when true. |
| `countryCode` | string | No | ISO country code (e.g., 'US', 'FR') to improve matching accuracy for person/company enrichment. |
| `deepTraffic` | boolean | No | Include detailed website traffic analysis when true. |
| `companyFrench` | boolean | No | Include SIREN directory data for French companies when true. |
| `whatsappCheck` | boolean | No | Verify if returned phone numbers are linked to WhatsApp accounts when true. |
| `companyKeyword` | string | No | Additional keywords to disambiguate company matches when multiple companies have similar names. |
| `companyPremium` | boolean | No | Include LinkedIn company information (employees, industry, location) when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Find Work Email

**Slug:** `DATAGMA_FIND_WORK_EMAIL`

Find verified work email address for a person using their name and company. Returns a professionally verified email address with validation metadata including SMTP checks and MX records. Requires either fullName or firstName+lastName, plus company domain or LinkedIn company slug.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company` | string | No | Company domain name (e.g., 'tesla.com') or company name. Required to identify the target company. |
| `fullName` | string | No | Full name of the person. Use this instead of firstName and lastName if you have the complete name. |
| `lastName` | string | No | Last name of the person to find email for. Can be used instead of fullName. |
| `firstName` | string | No | First name of the person to find email for. Can be used instead of fullName. |
| `linkedInSlug` | string | No | LinkedIn company slug URL. Accepts formats like 'https://www.linkedin.com/company/10625816', 'https://www.linkedin.com/company/livestorm/', or 'https://www.linkedin.com/sales/company/10625816'. If domain is not provided, it will be extracted from this. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Credits

**Slug:** `DATAGMA_GET_CREDITS`

Get the current credit balance for the authenticated Datagma API account. Use this to check how many API credits remain before making enrichment calls.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Email address associated with the API account (optional). If not provided, uses the authenticated account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Twitter Profile By Email

**Slug:** `DATAGMA_GET_TWITTER_BY_EMAIL`

Retrieve Twitter account information associated with an email address. This action looks up Twitter username and display name for a given email address using Datagma's enrichment database. Returns Twitter username, display name, and the queried email if a match is found, or status 'NOT_FOUND' if no Twitter account is associated with the email. Use this when you need to: - Find someone's Twitter handle from their email address - Verify if an email has an associated Twitter account - Enrich contact data with social media information

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | The email address to search for an associated Twitter account. Must be a valid email format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Twitter Profile by Username

**Slug:** `DATAGMA_GET_TWITTER_BY_USERNAME`

Enrich Twitter profile data using Datagma's database. Returns contact information (email), social media profiles (LinkedIn, Facebook, GitHub), and professional details (skills, interests, industry) associated with a Twitter username. Note: Not all usernames are in Datagma's database. A 'not found' response (code 5) indicates the username hasn't been indexed yet.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `username` | string | Yes | Twitter username without the '@' symbol (case-sensitive). Examples: 'jack', 'TwitterDev' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Reverse Phone Lookup

**Slug:** `DATAGMA_REVERSE_PHONE_LOOKUP`

Tool to reverse-lookup information associated with a phone number. Use when you have a phone number and need associated details (e.g., carrier, location).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | Phone number in E.164 format (e.g., '+14155552671') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Phone Numbers

**Slug:** `DATAGMA_SEARCH_PHONE_NUMBERS`

Find mobile phone numbers using email address and/or LinkedIn profile URL. Returns list of phone numbers with confidence scores and optional WhatsApp verification. Best results when both email and LinkedIn URL are provided.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apiId` | string | No | Datagma API key. Optional when Authorization header is provided by the connection. |
| `email` | string | No | Email address to search phone numbers for. Combine with username for best results. |
| `username` | string | No | LinkedIn or social media profile URL. Combine with email for best results. |
| `minimumMatch` | integer | No | Minimum confidence threshold for results (1-100). Lower values return more results with potentially lower confidence. |
| `whatsappCheck` | boolean | No | Enable WhatsApp verification for returned phone numbers. Adds processing time. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |