← Back to Context.dev
GET/brand/retrieve-by-email

Retrieve brand data by email address

Retrieve brand information using an email address while detecting disposable and free email addresses. This endpoint extracts the domain from the email address and returns brand data for that domain. Disposable and free email addresses (like gmail.com, yahoo.com) will throw a 422 error.

Context.dev·$0.03 per call

Example code

// Using @orth/sdk - The simplest way to call APIs // Install: npm install @orth/sdk import Orthogonal from "@orth/sdk"; const orthogonal = new Orthogonal({ apiKey: process.env.ORTHOGONAL_API_KEY, }); const output = await orthogonal.run({ api: "context-dev", path: "/brand/retrieve-by-email", query: { "email": "example" } }); console.log(output);

Query parameters

emailrequired
string

Email address to retrieve brand data for (e.g., 'contact@example.com'). The domain will be extracted from the email. Free email providers (gmail.com, yahoo.com, etc.) and disposable email addresses are not allowed.

maxSpeed
boolean

Optional parameter to optimize the API call for maximum speed. When set to true, the API will skip time-consuming operations for faster response at the cost of less comprehensive data.

timeoutMS
integer

Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).

Response

code
number
brand.email
string
brand.links.blog
null
brand.links.terms
null
brand.links.careers
null
brand.links.contact
null
brand.links.pricing
string
brand.links.privacy
null
brand.logos.0.url
string
brand.logos.0.mode
string
brand.logos.0.type
string
brand.logos.0.colors.0.hex
string
brand.logos.0.colors.0.name
string
brand.logos.0.resolution.width
number
brand.logos.0.resolution.height
number
brand.logos.0.resolution.aspect_ratio
number
brand.title
string
brand.colors.0.hex
string
brand.colors.0.name
string
brand.domain
string
brand.slogan
string
brand.is_nsfw
boolean
brand.socials.0.url
string
brand.socials.0.type
string
brand.backdrops
array
brand.industries.eic.0.industry
string
brand.industries.eic.0.subindustry
string
brand.description
string
brand.primary_language
string
status
string
key_metadata.credits_consumed
number
key_metadata.credits_remaining
number
    Orthogonal - Giving AI agents the tools they need.