POST /search

Changed on Oct 24, 2026

Search for public profile information associated with an email address.

Request

Base URL
https://api.behindtheemail.com/v1
Auth
HTTP bearer
TypeScript
https://skmtc.dev/behindtheemail/apis/behind-the-email-v1-api/docs/search/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

emailstring email required

The email address to enrich.

selectedProvidersstring[]

An optional list of specific providers to use. If not included, all providers will be used.

excludedProvidersstring[]

An optional list of specific providers to exclude. If not included, all providers will be used.

Response

Default Response

Changes

Oct 24, 20263834f1907ad2 Revision changes
- warning
  changed the pattern of the request property from ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ to ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
- info
  the /// response's property pattern was changed from ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ for the status
Sep 1, 20264d6ffc7d2574 Revision changes
- breaking
  the response property ////// became optional for the status
- breaking
  the response property /////// became optional for the status
- breaking
  the response property //////// became optional for the status
- breaking
  the response property //////// became optional for the status
- breaking
  the response property //////// became optional for the status
- breaking
  the response property ////// became optional for the status
- breaking
  the response property /////// became optional for the status
- breaking
  the response property /////// became optional for the status
- breaking
  the response property /////// became optional for the status
- breaking
  the response property ////// became optional for the status
- breaking
  the response property /////// became optional for the status
- breaking
  the response property //////// became optional for the status
- breaking
  the response property //////// became optional for the status
- breaking
  the response property //////// became optional for the status
- breaking
  the response property ////// became optional for the status
- breaking
  the response property /////// became optional for the status
- breaking
  the response property /////// became optional for the status
- breaking
  the response property /////// became optional for the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status

Operation history (3 revisions)

POST /search

Request

Request body

Response 200OK

Changes

Response