API


Authorization

Marcom Robot's APIs allow allows authentication via API keys. API keys are great for rapid prototyping. All endpoints support API Keys with Bearer Authentication.

In each example, the request is being made to this endpoint:

https://api.marcomrobot.com/v2/enrichment/domain/{company_domain}

Using an API key, which is added to the Authorization header

curl -X 'GET' \
  'https://api.marcomrobot.com/v2/enrichment/domain/{company_domain}' \
  -H 'accept: application/json'
  -H 'Authorization: Bearer {API_KEY}'
curl -X 'GET' \
  'https://api.marcomrobot.com/v2/enrichment/email/{company_email}' \
  -H 'accept: application/json'
  -H 'Authorization: Bearer {API_KEY}'

Domain Enrichment

Endpoint

Method URL Headers
GET https://api.marcomrobot.com/v2/enrichment/domain/{company_domain} Authentication: Bearer {API_KEY}

URL Parameters

company_domain (String) - Company domain


Request Example

curl -X 'GET' \
  'https://api.marcomrobot.com/v2/enrichment/domain/{company_domain}' \
  -H 'accept: application/json'
  -H 'Authorization: Bearer {API_KEY}'

Response Example

{
  "response_code": 200,
  "response_message": "OK",
  "company_name": "Company Name",
  "company_type": "Public",
  "domain": "test.com",
  "website": "https://www.test.com",
  "industry": "Consumer Goods",
  "employee_range": "50-250",
  "employee_count": 324,
  "year_founded": 2000,
  "annual_revenue": 1000000,
  "hq_country": "United States of America",
  "hq_state": "California",
  "hq_city": "San Francisco",
  "hq_street": "1st street 1",
  "hq_postalcode": "94104",
  "linkedin_url": "https://www.linkedin.com/company/test",
  "facebook_url": "https://www.facebook.com/test",
  "twitter_url": "https://twitter.com/test",
  "technologies": ["Operative", "Instagram", "Cisco Wireless"],
  "tags": ["Consumer Electronics", "Product Support", "Retail"],
  "addresses": ["United States of America California San Francisco 2nd street 2 94108"]
}

Email Enrichment

Endpoint

Method URL Headers
GET https://api.marcomrobot.com/v2/enrichment/email/{company_email} Authentication: Bearer {API_KEY}

URL Parameters

company_email (String) - Company email


Request Example

curl -X 'GET' \
  'https://api.marcomrobot.com/v2/enrichment/email/{company_email}' \
  -H 'accept: application/json'
  -H 'Authorization: Bearer {API_KEY}'

Response Example

{
  "response_code": 200,
  "response_message": "OK",
  "company_name": "Company Name",
  "company_type": "Public",
  "email": "[email protected]",
  "domain": "test.com",
  "website": "https://www.test.com",
  "industry": "Consumer Goods",
  "employee_range": "50-250",
  "employee_count": 324,
  "year_founded": 2000,
  "annual_revenue": 1000000,
  "hq_country": "United States of America",
  "hq_state": "California",
  "hq_city": "San Francisco",
  "hq_street": "1st street 1",
  "hq_postalcode": "94104",
  "linkedin_url": "https://www.linkedin.com/company/test",
  "facebook_url": "https://www.facebook.com/test",
  "twitter_url": "https://twitter.com/test",
  "technologies": ["Operative", "Instagram", "Cisco Wireless"],
  "tags": ["Consumer Electronics", "Product Support", "Retail"],
  "addresses": ["United States of America California San Francisco 2nd street 2 94108"]
}