> ## Documentation Index
> Fetch the complete documentation index at: https://docs.graphext.com/llms.txt
> Use this file to discover all available pages before exploring further.

# fetch_full_contact_domains

> Enrich a dataset containing links (URLs) to companies' online presence using the FullContact service. 

Will produce information about each company's social media accounts (including twitter, facebook, linkedin, etc.) and
other general information (industries it belongs to, location of its headquarter etc.). See below for the full list
of enrichment columns added by the step.

???+ info "API integration"
To use this step your team needs to have the *Full Contact* integration configured in Graphext. The corresponding credentials
are required to connect to a third-party API. You can configure API integrations following the `INTEGRATIONS` or `ADD INTEGRATION`
link in the top-left corner of your Team's page, selecting `API keys`, and then the name of the desired third-party service.

To enable the *Full Contact* integration in particular you will need access to Full Contact's service. Follow the instructions
[here](https://www.fullcontact.com/developer-portal/) to create the required API key.

## Usage

The following example shows how the step can be used in a recipe.

<Accordion title="Examples" icon="code" defaultOpen="true">
  <Tabs>
    <Tab title="Example 1">
      Since the step has no configuration parameters, it's simply

      ```stan theme={null}
      fetch_full_contact_domains(ds.company) -> (
        ds.domain,
        ds.name,
        ds.location,
        ds.twitter,
        ds.linkedin,
        ds.facebook,
        ds.bio,
        ds.logo,
        ds.website,
        ds.founded,
        ds.employees,
        ds.locale,
        ds.category,
        ds.angellist_profile,
        ds.angellist_bio,
        ds.angellist_followers,
        ds.twitter_url,
        ds.twitter_bio,
        ds.twitter_followers,
        ds.twitter_following,
        ds.crunchbase_url,
        ds.crunchbase_bio,
        ds.linkedin_url,
        ds.linkedin_bio,
        ds.linkedin_followers,
        ds.facebook_url,
        ds.location_formatted,
        ds.industries,
        ds.keywords,
        ds.global_traffic_rank
      )
      ```
    </Tab>

    <Tab title="Signature">
      General syntax for using the step in a recipe. Shows the inputs and outputs the step is expected to receive and will produce respectively. For futher details see sections below.

      ```stan theme={null}
      fetch_full_contact_domains(domain: category, {
          "param": value,
          ...
      }) -> (
      	name: category,
      	location: category,
      	twitter: category,
      	linkedin: category,
      	facebook: category,
      	bio: text,
      	logo: url,
      	website: url,
      	founded: number,
      	employees: number,
      	locale: category,
      	category: category,
      	angellist_profile: url,
      	angellist_bio: text,
      	angellist_followers: number,
      	twitter_url: url,
      	twitter_bio: text,
      	twitter_followers: number,
      	twitter_following: number,
      	crunchbase_url: url,
      	crunchbase_bio: text,
      	linkedin_url: url,
      	linkedin_bio: text,
      	linkedin_followers: number,
      	facebook_url: url,
      	location_formatted: category,
      	industries: list[category],
      	keywords: list[category],
      	global_traffic_rank: number
      )
      ```
    </Tab>
  </Tabs>
</Accordion>

## Inputs & Outputs

The following are the inputs expected by the step and the outputs it produces. These are generally
columns (`ds.first_name`), datasets (`ds` or `ds[["first_name", "last_name"]]`) or models (referenced
by name e.g. `"churn-clf"`).

<Accordion title="Inputs" icon="right-to-bracket">
  <ParamField path="domain" type="column[category]" required>
    Categorical column containing domain of the company to fetch information for.
  </ParamField>
</Accordion>

<Accordion title="Outputs" icon="right-from-bracket">
  <ParamField path="name" type="column[category]" required>
    Categorical column containing the name of the company.
  </ParamField>

  <ParamField path="location" type="column[category]" required>
    Last known location of the company.
  </ParamField>

  <ParamField path="twitter" type="column[category]" required>
    Column containing the Twitter profile of the company.
  </ParamField>

  <ParamField path="linkedin" type="column[category]" required>
    Column containing the LinkedIn profile of the company.
  </ParamField>

  <ParamField path="facebook" type="column[category]" required>
    Column containing the Facebook profile of the company.
  </ParamField>

  <ParamField path="bio" type="column[text]" required>
    Column containing the biography most relevant to the company from their social media profiles.
  </ParamField>

  <ParamField path="logo" type="column[url]" required>
    URL of the logo of the company.
  </ParamField>

  <ParamField path="website" type="column[url]" required>
    URL pointing to the website of the company.
  </ParamField>

  <ParamField path="founded" type="column[number]" required>
    Date the company was founnded.
  </ParamField>

  <ParamField path="employees" type="column[number]" required>
    Approximation of the number of employees.
  </ParamField>

  <ParamField path="locale" type="column[category]" required>
    Locale relevant to the company.
  </ParamField>

  <ParamField path="category" type="column[category]" required>
    Category the company belongs to.
  </ParamField>

  <ParamField path="angellist_profile" type="column[url]" required>
    URL of the AngelList company profile.
  </ParamField>

  <ParamField path="angellist_bio" type="column[text]" required>
    Biography from the AngelList company profile.
  </ParamField>

  <ParamField path="angellist_followers" type="column[number]" required>
    Number of followers the company currently has on AngelList.
  </ParamField>

  <ParamField path="twitter_url" type="column[url]" required>
    URL of the Twitter company profile.
  </ParamField>

  <ParamField path="twitter_bio" type="column[text]" required>
    Biography from the Twitter company profile.
  </ParamField>

  <ParamField path="twitter_followers" type="column[number]" required>
    Number of followers the company currently has on Twitter.
  </ParamField>

  <ParamField path="twitter_following" type="column[number]" required>
    Number of profiles the company currently follows on Twitter.
  </ParamField>

  <ParamField path="crunchbase_url" type="column[url]" required>
    URL of the Crunchbase company profile.
  </ParamField>

  <ParamField path="crunchbase_bio" type="column[text]" required>
    Biography from the CrunchBase company profile.
  </ParamField>

  <ParamField path="linkedin_url" type="column[url]" required>
    URL of the LinkedIn company profile.
  </ParamField>

  <ParamField path="linkedin_bio" type="column[text]" required>
    Biography from the LinkedIn company profile.
  </ParamField>

  <ParamField path="linkedin_followers" type="column[number]" required>
    Number of profiles the company currently follows on LinkedIn.
  </ParamField>

  <ParamField path="facebook_url" type="column[url]" required>
    URL of the Facebook company profile.
  </ParamField>

  <ParamField path="location_formatted" type="column[category]" required>
    Last location known to the company's headquarters.
  </ParamField>

  <ParamField path="industries" type="column[list[category]]" required>
    List of industries the company belongs to.
  </ParamField>

  <ParamField path="keywords" type="column[list[category]]" required>
    List of keywords the company is associated to.
  </ParamField>

  <ParamField path="global_traffic_rank" type="column[number]" required>
    Rank in the global web traffic for the company.
  </ParamField>
</Accordion>

## Configuration

The following parameters can be used to configure the behaviour of the step by including them in
a json object as the last "input" to the step, i.e. `step(..., {"param": "value", ...}) -> (output)`.

<Accordion title="Parameters" defaultOpen="true" icon="sliders">
  <ParamField path="integration" type="string" required>
    ID of the integration you'd like to use.
  </ParamField>
</Accordion>