GetUserEnrichment - ThriveStack API Reference

Success rates

Work email

50–70% success rate. Work emails from company domains enrich much more reliably.

Personal email

<50% success rate for gmail.com, yahoo.com, and similar free providers.

For best results, collect a work email during signup. Always check the found field before reading enrichedData.

Endpoint

This is a GraphQL query sent over HTTP POST.

POST /growth-intelligence

Authentication

content-type: application/json
x-api-key: YOUR_API_KEY

Input

Variable	Type	Required	Description
`input.email`	String	Yes	The user's email address. Work emails yield higher enrichment success rates.
`input.userId`	String	No	Optional user ID to correlate the enrichment result with a known user.

GraphQL query

query GetUserEnrichment($input: GetUserEnrichmentRequest!) {
  getUserEnrichment(input: $input) {
    found
    enrichedData {
      firstName
      lastName
      fullName
      avatarUrl
      contactInfo {
        phoneNumbers
      }
      employmentInfo {
        companyName
        companyDomain
        jobTitle
        jobRole
        seniorityLevel
        jobSubRole
      }
      socialProfiles {
        twitterUrl
        facebookUrl
        githubUrl
        linkedinUrl
      }
      locationInfo {
        city
        country
        countryCode
        fullLocation
        state
        stateCode
        timeZone
      }
    }
  }
}

Example

cURL

curl --location 'https://api.app.thrivestack.ai/growth-intelligence' \
--header 'content-type: application/json' \
--header 'x-api-key: YOUR_API_KEY' \
--data '{
  "operationName": "GetUserEnrichment",
  "variables": {
    "input": {
      "email": "jane.doe@acme.com"
    }
  },
  "query": "query GetUserEnrichment($input: GetUserEnrichmentRequest!) { getUserEnrichment(input: $input) { found enrichedData { firstName lastName fullName employmentInfo { jobTitle jobRole seniorityLevel companyName } locationInfo { city country } socialProfiles { linkedinUrl } } } }"
}'

JavaScript

const response = await fetch("https://api.app.thrivestack.ai/growth-intelligence", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "x-api-key": "YOUR_API_KEY"
  },
  body: JSON.stringify({
    operationName: "GetUserEnrichment",
    variables: { input: { email: "jane.doe@acme.com" } },
    query: `query GetUserEnrichment($input: GetUserEnrichmentRequest!) {
  getUserEnrichment(input: $input) {
    found
    enrichedData {
      firstName lastName fullName
      employmentInfo { jobTitle jobRole seniorityLevel companyName }
      locationInfo { city country }
      socialProfiles { linkedinUrl }
    }
  }
}`
  })
});
const { data } = await response.json();
if (data.getUserEnrichment.found) {
  console.log(data.getUserEnrichment.enrichedData);
}

Response fields

Field	Type	Description
`found`	Boolean	Whether enrichment data was found. Always check before reading `enrichedData`.

enrichedData — Basic

Field	Type	Description
`firstName`	String	Given name. Example: `"Jane"`
`lastName`	String	Family name. Example: `"Doe"`
`fullName`	String	Full display name. Example: `"Jane Doe"`
`avatarUrl`	String	Profile avatar image URL.

enrichedData — employmentInfo

Field	Type	Description
`companyName`	String	Current employer. Example: `"Acme Corp"`
`companyDomain`	String	Employer domain. Example: `"acme.com"`
`jobTitle`	String	Current job title. Example: `"Senior Software Engineer"`
`jobRole`	String	High-level role. Example: `"Engineering"`, `"Sales"`, `"Marketing"`
`seniorityLevel`	String	Seniority. Example: `"Senior"`, `"Manager"`, `"VP"`
`jobSubRole`	String	More specific sub-role. Example: `"Platform"`, `"Frontend"`

enrichedData — socialProfiles

Field	Type	Description
`linkedinUrl`	String	Full LinkedIn profile URL.
`twitterUrl`	String	Full Twitter profile URL.
`githubUrl`	String	Full GitHub profile URL.
`facebookUrl`	String	Full Facebook profile URL.

enrichedData — locationInfo

Field	Type	Description
`city`	String	City of residence.
`state`	String	State or region.
`stateCode`	String	State/region code (e.g., `"CA"`).
`country`	String	Country name.
`countryCode`	String	ISO country code (e.g., `"US"`).
`fullLocation`	String	Human-readable full location.
`timeZone`	String	IANA time zone (e.g., `"America/Los_Angeles"`).

Example response

{
  "data": {
    "getUserEnrichment": {
      "found": true,
      "enrichedData": {
        "firstName": "Jane",
        "lastName": "Doe",
        "fullName": "Jane Doe",
        "avatarUrl": "https://example.com/avatar.jpg",
        "contactInfo": {
          "phoneNumbers": ["+1-555-0100"]
        },
        "employmentInfo": {
          "companyName": "Acme Corp",
          "companyDomain": "acme.com",
          "jobTitle": "Senior Software Engineer",
          "jobRole": "Engineering",
          "seniorityLevel": "Senior",
          "jobSubRole": "Platform"
        },
        "socialProfiles": {
          "linkedinUrl": "https://linkedin.com/in/janedoe",
          "twitterUrl": "https://twitter.com/janedoe",
          "githubUrl": "https://github.com/janedoe",
          "facebookUrl": "https://facebook.com/janedoe"
        },
        "locationInfo": {
          "city": "San Francisco",
          "state": "California",
          "stateCode": "CA",
          "country": "United States",
          "countryCode": "US",
          "fullLocation": "San Francisco, CA, United States",
          "timeZone": "America/Los_Angeles"
        }
      }
    }
  }
}