Name2Domain API Documentation (v1)

The Name2Domain API enables you to convert company names in your CRM or database into accurate company websites and domains.

Calling the API

V1 of the API is hosted at https://www.name2domain.com/api/v1. All calls use this URL as the base.

Authentication

Name2Domain uses token-based authentication. If you're logged into your Name2Domain account, you'll see your API key below.

<<log in to see your key>>

Simply include key as a query parameter or a header parameter in your queries, like this:

https://www.name2domain.com/api/v1/convert?key=<<log in to see your key>>&company=tesla

If you don't include an API key or use the wrong one, Name2Domain will respond with a 401 authorization error.

Status and Error Codes

Here are the most common HTTP status codes you may receive from our API and what they mean.

• 200: Request and response were successful.
• 401: The API key you used was not found.
• 404: The path you called is not accessible from your account.
• 405: The method you attempted was not allowed.
• 500: There was a server error.

One-off Convert Company Name

Convert company name to domain

Given a company name string this method will find and return the best website domain.

Example

GET https://www.name2domain.com/api/v1/convert?key=<<log in to see your key>>&company=tesla

Result

{
  "status": "SUCCESS",
  "message": "Converted company name.",
  "data": {
    "domain": "tesla.com",
    "title": "Electric Cars, Solar Panels & Clean Energy Storage | Tesla",
    "description": "Tesla is accelerating the world's transition to sustainable energy with electric cars, solar panels and integrated renewable energy solutions for homes and businesses.",
    "keywords": "Tesla, Electric Vehicles, EV, Electric Cars, Elon Musk, Sustainable Energy, Autopilot, Supercharger, Model S, Model X, Model 3, Model Y, Roadster, Energy, Powerwall, Powerpack, Megapack, Battery Storage",
    "location_state": "California",
    "location_city": "Palo Alto",
    "employee_number_from": 10000,
    "employee_number_to": 50000,
    "sic_code": "",
    "annual_revenue": 21461268000.0,
    "social_linkedin": "company/tesla-motors",
    "social_facebook": "",
    "social_twitter": "Tesla",
    "found_emails": "",
    "legal_name": "Tesla, Inc.",
    "company_type": "is_public",
    "tags": [
      "Renewables & Environment",
      "Energy",
      "Automotive",
      "Marketplace",
      "B2C"
    ],
    "industry_group": "Independent Power and Renewable Electricity Producers",
    "industry": "Renewable Electricity",
    "sub_industry": "Renewable Energy",
    "founded_year": 2003,
    "location_street_number": "3500",
    "location_street_name": "Deer Creek Road",
    "location_zip": "94304",
    "location_state_code": "CA",
    "location_country": "United States",
    "location_country_code": "US",
    "lat": 37.394838,
    "lng": -122.150389,
    "logo_url": "https://logo.clearbit.com/tesla.com",
    "ticker": "TSLA",
    "alexa_us_rank": 440,
    "alexa_global_rank": 1341,
    "google_rank": "",
    "employee_number": 45000,
    "market_cap": 55330000000.0,
    "raised": "",
    "fortune_1000_rank": ""
  }
}

Bulk Convert Company Names

Batches

List batches

This is the index call for your batches. Batches store the bulk company data you submit for processing. A status attibute on the batch will tell you whether the batch is still processing or finished.

Example

GET https://www.name2domain.com/api/v1/batches?key=<<log in to see your key>>

Result

{
  "status": "SUCCESS",
  "message": "Loaded all batches.",
  "data": [
    {
      "id": 24,
      "user_id": 1,
      "name": "Marketing batch A",
      "created_at": "2020-02-04T23:38:06.876Z",
      "updated_at": "2020-02-04T23:38:06.955Z",
      "status": "ready"
    }
  ],
  "last_page": true,
  "total_count": 1
}

Create a batch

Add a batch of company names to process on your account.

Parameters

Example

POST https://www.emailfinder.io/api/v1/batches

Result

{
  "status": "SUCCESS",
  "message": "Created batch.",
  "data": {
    "id": 24,
    "user_id": 1,
    "name": "Marketing batch A",
    "created_at": "2020-02-04T23:38:06.876Z",
    "updated_at": "2020-02-04T23:38:06.955Z",
    "status": "ready"
  }
}

Export a batch

This is the index call for the data in a batch. To export all your data, you must do so on a batch-by-batch basis.

Example

GET https://www.emailfinder.io/api/v1/batches/<batch_id>?key=<<log in to see your key>>

Result

{
  "status": "SUCCESS",
  "message": "Loaded data.",
  "data": [
    {
      "name": "scripted",
      "converted_at": "2020-02-16T18:55:50.688Z",
      "domain": "scripted.com"
    },
    {
      "name": "trackjobchanges.com",
      "converted_at": "2020-02-16T18:55:51.158Z",
      "domain": "trackjobchanges.com"
    },
    {
      "name": "jsx jetsuite",
      "converted_at": "2020-02-16T18:55:52.022Z",
      "domain": "jetsuite.com"
    }
  ]
}

Company Details

Get Firmographic Information by Domain

Given a domain this method will return firmographic information.

Parameters

Example

GET https://www.name2domain.com/api/v1/details?key=<<log in to see your key>>&domain=tesla.com

Result

{
  "status": "SUCCESS",
  "message": "Found company.",
  "data": {
    "domain": "tesla.com",
    "title": "Electric Cars, Solar Panels & Clean Energy Storage | Tesla",
    "description": "Tesla is accelerating the world's transition to sustainable energy with electric cars, solar panels and integrated renewable energy solutions for homes and businesses.",
    "keywords": "Tesla, Electric Vehicles, EV, Electric Cars, Elon Musk, Sustainable Energy, Autopilot, Supercharger, Model S, Model X, Model 3, Model Y, Roadster, Energy, Powerwall, Powerpack, Megapack, Battery Storage",
    "location_state": "California",
    "location_city": "Palo Alto",
    "employee_number_from": 10000,
    "employee_number_to": 50000,
    "sic_code": "",
    "annual_revenue": 21461268000.0,
    "social_linkedin": "company/tesla-motors",
    "social_facebook": "",
    "social_twitter": "Tesla",
    "found_emails": "",
    "legal_name": "Tesla, Inc.",
    "company_type": "is_public",
    "tags": [
      "Renewables & Environment",
      "Energy",
      "Automotive",
      "Marketplace",
      "B2C"
    ],
    "industry_group": "Independent Power and Renewable Electricity Producers",
    "industry": "Renewable Electricity",
    "sub_industry": "Renewable Energy",
    "founded_year": 2003,
    "location_street_number": "3500",
    "location_street_name": "Deer Creek Road",
    "location_zip": "94304",
    "location_state_code": "CA",
    "location_country": "United States",
    "location_country_code": "US",
    "lat": 37.394838,
    "lng": -122.150389,
    "logo_url": "https://logo.clearbit.com/tesla.com",
    "ticker": "TSLA",
    "alexa_us_rank": 440,
    "alexa_global_rank": 1341,
    "google_rank": "",
    "employee_number": 45000,
    "market_cap": 55330000000.0,
    "raised": "",
    "fortune_1000_rank": ""
  }
}