The Name2Domain API enables you to convert company names in your CRM or database into accurate company websites and domains.
V1 of the API is hosted at https://www.name2domain.com/api/v1
. All calls use this URL as the base.
Name2Domain uses token-based authentication. If you're logged into your Name2Domain account, you'll see your API key below.
Your API key is:
<<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.
Here are the most common HTTP status codes you may receive from our API and what they mean.
Given a company name string this method will find and return the best website domain.
GET https://www.name2domain.com/api/v1/convert?key=<<log in to see your key>>&company=tesla
{ "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": "" } }
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.
GET https://www.name2domain.com/api/v1/batches?key=<<log in to see your key>>
{ "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 }
Add a batch of company names to process on your account.
key | Your API key | required |
name | A name to identify or describe your batch | required |
data | Array of JSON-formatted companies. Each item must include a company key. |
required |
webhook_url | Fully-formed URL to accept a POST request containing the batch attributes when the batch status changes to finished . |
optional |
POST https://www.emailfinder.io/api/v1/batches
{ "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" } }
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.
GET https://www.emailfinder.io/api/v1/batches/<batch_id>?key=<<log in to see your key>>
{ "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" } ] }
Given a domain this method will return firmographic information.
key | Your API key | required |
domain | The domain you want firmographic details on | required |
GET https://www.name2domain.com/api/v1/details?key=<<log in to see your key>>&domain=tesla.com
{ "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": "" } }
© 2023 Toofr LLC. All rights reserved.