Tomba | Tomba Documentation

Tomba

Endpointhttps://api.tomba.io/v1

Email Sources

GET

https://api.tomba.io/v1

/email-sources

Find email address source somewhere on the web.

Email Sources › query Parameters

email

string · required

The email address you want to find sources.

Email Sources › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Email Sources › Responses

Email sources found successfully

email

string

object[]

GET/email-sources

curl --request GET \
  --url 'https://api.tomba.io/v1/email-sources?email=m%40wordpress.org' \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'

shell

Example Responses

{
  "email": "email",
  "data": [
    {
      "uri": "uri",
      "extracted_on": "extracted_on",
      "last_seen_on": "last_seen_on",
      "still_on_page": true,
      "website_url": "website_url"
    }
  ]
}

json

application/json

Domain status

GET

https://api.tomba.io/v1

/domain-status

Returns domain status if is webmail or disposable.

Domain status › query Parameters

domain

string · required

Domain name from which you want to check.

Domain status › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Domain status › Responses

Domain status retrieved successfully

No data returned

GET/domain-status

curl --request GET \
  --url 'https://api.tomba.io/v1/domain-status?domain=gmail.com' \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'

shell

Example Responses

No example specified for this content type

Similar

GET

https://api.tomba.io/v1

/similar

This endpoint allows you to retrieve similar domains based by a specific domain.

Similar › query Parameters

domain

string · required

Domain name from which you want to find similar domains. For example, stripe.com

Similar › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Similar › Responses

Similar domains retrieved successfully

object[]

GET/similar

curl --request GET \
  --url 'https://api.tomba.io/v1/similar?domain=tomba.io' \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'

shell

Example Responses

{
  "data": [
    {
      "website_url": "website_url",
      "name": "name"
    }
  ]
}

json

application/json

Technology

GET

https://api.tomba.io/v1

/technology

This endpoint allows you to retrieve the technologies used by a specific domain.

Technology › query Parameters

domain

string · required

Domain name from which you want to find the technology. For example, stripe.com

Technology › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Technology › Responses

Technologies retrieved successfully

domain

string

object[]

GET/technology

curl --request GET \
  --url 'https://api.tomba.io/v1/technology?domain=tomba.io' \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'

shell

Example Responses

{
  "domain": "domain",
  "data": [
    {
      "slug": "slug",
      "name": "name",
      "icon": "icon",
      "website": "website",
      "categories": {
        "id": 0,
        "slug": "slug",
        "name": "name"
      }
    }
  ]
}

json

application/json

Keys

Email Sources

GET

https://api.tomba.io/v1

/email-sources

Find email address source somewhere on the web.

Email Sources › query Parameters

email

string · required

The email address you want to find sources.

Email Sources › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Email Sources › Responses

Email sources found successfully

email

string

object[]

Domain status

GET

https://api.tomba.io/v1

/domain-status

Returns domain status if is webmail or disposable.

Domain status › query Parameters

domain

string · required

Domain name from which you want to check.

Domain status › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Domain status › Responses

Domain status retrieved successfully

No data returned

Similar

GET

https://api.tomba.io/v1

/similar

This endpoint allows you to retrieve similar domains based by a specific domain.

Similar › query Parameters

domain

string · required

Domain name from which you want to find similar domains. For example, stripe.com

Similar › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Similar › Responses

Similar domains retrieved successfully

object[]

Technology

GET

https://api.tomba.io/v1

/technology

This endpoint allows you to retrieve the technologies used by a specific domain.

Technology › query Parameters

domain

string · required

Domain name from which you want to find the technology. For example, stripe.com

Technology › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Technology › Responses

Technologies retrieved successfully

domain

string

object[]