Back to catalog

Context Dev · Company

Context API / Retrieve brand data

Retrieve logos, backdrops, colors, industry, description, and more. Provide exactly one lookup identifier in the request body: a domain, company name, email address, stock ticker, transaction descriptor, or direct URL. Note: bydirecturl fetches brand data only from the provided URL — not from the entire internet.

Private Gateway connection

Data below comes from the configured private Gateway. Provider activation remains governed by its evidence and policy gates.

unverifiedRequest shape unavailableUnverified
Published API evidence
Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

  • city body · optional

    Optional city name to prioritize when searching for the brand.

  • country_gl body · optional

    Optional country code hint (GL parameter) to specify the country when identifying a transaction.

  • direct_url body · optional

    Full http(s) URL to fetch brand data from (e.g., 'https://stripe.com/enterprise'). Only this URL is fetched — not the entire internet.

  • domain body · optional

    Domain name to retrieve brand data for (e.g., 'stripe.com').

  • email body · optional

    Email address to retrieve brand data for (e.g., 'jane.doe@example.com').

  • force_language body · optional
  • high_confidence_only body · optional

    When set to true, the API performs additional verification to ensure the identified brand matches the transaction with high confidence.

  • maxAgeMs body · optional

    Maximum age in milliseconds for cached brand data before the API performs a hard refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms) are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1 year.

  • maxSpeed body · optional

    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.

  • mcc body · optional

    Optional Merchant Category Code (MCC) to help identify the business category or industry.

  • name body · optional

    Company name to retrieve brand data for (e.g., 'Apple Inc').

  • phone body · optional

    Optional phone number from the transaction to help verify brand match.

  • tags body · optional

    Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.

  • ticker body · optional

    Stock ticker symbol to retrieve brand data for (e.g., 'AAPL').

  • ticker_exchange body · optional

    Optional stock exchange for the ticker. Defaults to NASDAQ if not specified.

  • timeoutMS body · optional

    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).

  • transaction_info body · optional

    Transaction information to identify the brand.

  • type body · optional

    Discriminator for transaction-based brand retrieval.

Sign in to run this operation, inspect live eligibility, and see governed execution and audit evidence. Sign in.

Context API / Retrieve brand data · looot