Orsa
Docs
IDENTIFICATION

The merchant,
from the descriptor.

Turn 'SQ *BLUE BOTTLE 4471' into Blue Bottle Coffee, with a logo, a category, and a website — built for neobanks and expense tools.

Try the endpointRead the docs
Sign up for free — access all APIs

Resolve a bank descriptor to a merchant and category.

Start free, no card required, most teams ship a first integration in under ten minutes.

Why this endpoint exists

Not another JSON page.
A production workflow in one call

One call in. A resolved merchant out.

Without Orsa

Before Orsa

  • A browser worker, proxy account, parser, retry queue, and schema contract for one endpoint.
  • Product teams wait while platform teams debug website-specific failures.
  • Every new data field becomes another brittle scraper branch.
With Orsa

After Orsa

  • One call in. A resolved merchant out. With retries, rendering, and validation handled behind the API.
  • The response shape is typed, documented, and ready for product code.
  • Teams combine it with adjacent Orsa endpoints without adding vendors.
How it works

Teach the workflow,
then show the endpoint

Point Orsa at a merchant descriptor, let the platform handle the web work, and receive a response your product can trust.

Input01

Send a merchant descriptor

SQ *BLUE BOTTLE 4471

Orsa runtime02

Render, retry, enrich

Orsa handles browser execution, proxy escalation, parsing, validation, caching, and typed response shaping behind the API.

Output03

One call in. A resolved merchant out.

Use the result in card feeds without owning the extraction stack.

REST path
/api/v1/brand/retrieveSame endpoint used by the SDK examples below.
Input shape
merchant descriptorSQ *BLUE BOTTLE 4471
SDKs
TypeScript, Python, cURLStart with TypeScript, Python, or direct cURL.
Best first use
Card feedsReplace cryptic strings with recognizable brands.
Production numbers

Performance your product
can actually plan around

Every endpoint page should answer the practical buying question: will this hold up once it leaves the demo?

p50 latency420msMeasured as production API latency, not a static mock.
p99 latency1.6sBuilt for the long tail of real websites and crawler paths.
quality bar94.1% merchant resolution on sampled processors94.1% merchant resolution on sampled processors
credits per call1 keySelf-serve usage with predictable metering and no scraping infrastructure to own.
Feature layer

More than the response.
The operating layer behind it

Stripe pages teach the system around the API: inputs, retries, observability, adjacent products, and the code path. This section does the same for Orsa endpoints.

  • Typed response contracts for product code and AI tools.
  • Browser, proxy, cache, and validation logic handled by Orsa.
  • Direct fit for card feeds and expense automation.

Endpoint

/api/v1/brand/retrieve

Example input

SQ *BLUE BOTTLE 4471

Promise

One call in. A resolved merchant out.

Pairs with

NAICS Classification, Company Logos, Company Description

Built for the job

What teams ship with
the merchant, from the descriptor.

Each product page now speaks to the real workflow behind the endpoint, with concrete jobs instead of a generic feature list.

01

Card feeds

Replace cryptic strings with recognizable brands.

02

Expense automation

Route spend to the right GL without user edits.

03

Risk signals

Ground alerts in merchant identities, not raw strings.

Implementation

Keep the code small.
Let Orsa do the messy part

Use the endpoint directly, then combine it with adjacent Orsa APIs as the workflow grows.

Get an API keyAPI reference
request
Responsetyped json
{
  "transaction_info": "SQ *BLUE BOTTLE 4471",
  "name": "Blue Bottle Coffee",
  "domain": "bluebottlecoffee.com",
  "naics": "722515",
  "logo": "https://cdn.orsa.dev/bluebottlecoffee.com/logo.svg"
}
Combine with

Build the full workflow,
not another point solution

The best product integrations usually combine two or three Orsa endpoints behind one customer experience.

NAICS ClassificationCompany LogosCompany Description
FAQ

The questions teams ask
before shipping

Short answers for the practical details: rendering, limits, freshness, and how this fits into production.

Get started

Put this endpoint
in your product today

Try the live endpoint, then wire the same response into your app with one API key.

Try this endpoint

One API key for every Orsa endpoint · No card required to start.

Orsa

Turn any URL into structured data. Instantly, with a single API.

Engineering essays, API updates, and customer stories. Weekly, no spam.

Products

  • Scrape HTML
  • Scrape Markdown
  • Scrape Images
  • Scrape Sitemap
  • Company Logos
  • Company Colors
  • Company Styleguide
  • Transaction Identification
  • Website Screenshot
  • View all 15 →

Use cases

  • Power LLMs with Web Context
  • Logo Link
  • Reduce Onboarding Friction
  • Automated Brand Kits
  • Programmatic Theming
  • Enrich Company Profiles
  • Transaction & Billing Data
  • Stock Ticker Enrichment
  • Zapier Automations

Compare

  • vs Brandfetch
  • vs Clearbit
  • vs Logo.dev
  • vs Klazify
  • vs RiteKit
  • vs Parget
  • All comparisons →

Developers

  • Documentation
  • Changelog
  • TypeScript SDK
  • Python SDK
  • Ruby SDK
  • MCP
  • Status
  • API reference
  • Playground

Free tools

  • AI-SEO / GEO Checker
  • Design Extractor for LLMs
  • Sitemap Generator
  • URL to Markdown
  • Open Graph Checker
  • Email Signature Generator
  • DNS Lookup
  • Twitter Card Validator
  • Brand Font Finder

Company

  • Blog
  • Customers
  • Pricing
  • FAQ
  • Contact
  • Security
  • Acceptable Use
  • Request Brand Update
  • Careers

© 2026 Orsa Workshops, Inc.

PrivacyTermsDPAChart the web
ORSA