canonical: https://jentic.com/apis/markerapi.com/marker

# Markerapi Marker Trademark Search API

Jentic publishes the only available OpenAPI specification for Marker Trademark Search API, keeping it validated and agent-ready. Marker is a US trademark search service that wraps USPTO data with a simple HTTP API. The five endpoints support lookup by serial number, search by trademark name, search within trademark descriptions, search by owner name, and a query for trademarks expiring within a configurable timeframe. Pagination is built into the search endpoints via a `start` parameter and credentials are passed inside the URL path on every request.

## For AI agents

Search USPTO trademark records by serial number, name, description, owner, or expiration window via five endpoints. Credentials are passed in the URL path on every request.

## Scope

Does not handle patent search, copyright registration, international trademark filings, or trademark filing submission - use for searching US trademark records only.

## Capabilities

- Look up a US trademark by serial number through `/trademarks/serial/{serialNumber}/...`
- Search trademarks by name with `/trademarks/trademark/{searchTerm}/status/{status}/start/{start}/...`
- Search trademark descriptions for a phrase using `/trademarks/description/{searchTerm}/status/{status}/start/{start}/...`
- Find every trademark held by a given owner via `/trademarks/owner/{ownerName}/status/{status}/start/{start}/...`
- List trademarks expiring within a chosen timeframe using `/trademarks/expiration/{timeframe}/start/{start}/...`
- Filter every search by trademark status (live, dead, all) without changing endpoint
- Page through long result sets by incrementing the `start` parameter on each call

## Use cases

### Brand Name Clearance Search

Branding agencies and product teams call `/trademarks/trademark/{searchTerm}/status/live/...` before committing to a new product or company name. The endpoint returns every live US trademark matching the search term so the legal team can flag conflicts early. A typical clearance run pages through several hundred results in a single sitting.

Example prompt: Call `/trademarks/trademark/Acme/status/live/start/0` and return the count of live matches plus the first page of results.

### Owner Portfolio Monitoring

Competitive-intelligence and IP-management tools call `/trademarks/owner/{ownerName}/status/all/start/{start}` on a schedule to track a competitor's trademark portfolio. The endpoint returns every trademark filed under that owner and pagination is handled through the `start` parameter, so a nightly job can compare today's set against yesterday's snapshot.

Example prompt: Page through `/trademarks/owner/AcmeCorp/status/all/start/{n}` until fewer than 100 results are returned and write the diff against yesterday's snapshot to disk.

### Renewal Pipeline Forecasting

Trademark filing firms call `/trademarks/expiration/{timeframe}/start/{start}` to surface trademarks coming up for renewal so they can pitch renewal services to the relevant owners. The timeframe path parameter selects the look-ahead window and pagination is via `start`. A working integration into a CRM is typically a couple of days.

Example prompt: Call `/trademarks/expiration/90/start/0` and return every trademark whose owner field matches a list of target firms in a CSV.

### Description Phrase Search

Patent and trademark research teams call `/trademarks/description/{searchTerm}/status/{status}/start/{start}` to find trademarks whose registered goods-and-services description mentions a specific phrase, which is useful for prior-art-style competitive research and for spotting filings that touch a new product category.

Example prompt: Call `/trademarks/description/wireless`%20charging/status/live/start/0 and return the first 100 matching trademarks for review.

### AI Agent Trademark Lookup

An AI agent embedded in a legal or product-research workflow calls Marker through Jentic to clear brand names, monitor owner portfolios, and surface upcoming renewals without bespoke client code. Jentic exposes each Marker endpoint as a typed tool with a discoverable input schema so the agent invokes the right search variant based on the user's question.

Example prompt: Search Jentic for 'check whether a brand name is registered as a US trademark', load the schema for `/trademarks/trademark/{searchTerm}/status/live/start/0`, and execute the call for the candidate name.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/trademarks/serial/{serialNumber}/username/{username}/password/{password}` | Look up a trademark by USPTO serial number |
| GET | `/trademarks/trademark/{searchTerm}/status/{status}/start/{start}/username/{username}/password/{password}` | Search trademarks by name with status filter |
| GET | `/trademarks/description/{searchTerm}/status/{status}/start/{start}/username/{username}/password/{password}` | Search trademark descriptions |
| GET | `/trademarks/owner/{ownerName}/status/{status}/start/{start}/username/{username}/password/{password}` | List trademarks by owner |
| GET | `/trademarks/expiration/{timeframe}/start/{start}/username/{username}/password/{password}` | List trademarks by expiration window |

## Key resources

- **Trademarks** — All five endpoints - serial, name, description, owner, expiration - under /trademarks

## Why Jentic

- **Setup:** Wiring Marker by hand means placing your username and password directly into every request URL, learning the serial, trademark, description, owner, and expiration search paths, and handling paging yourself. Through Jentic you install once, import the Marker Trademark Search API from the API Directory, store the credentials once, and your agent calls it.
- **Permission scoping:** The Marker endpoints are read-only trademark searches, so scoping is by operation: you limit the agent to the operations it needs, such as searching by trademark term or owner, or listing expiring marks, and leave out the rest. Every operation you allow is one you have chosen, so the agent stays inside that set.
- **Credential handling:** Your Marker username and password are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'check whether a name is trademarked' or 'find expiring trademarks', and Jentic returns the matching Marker operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **USPTO BDSS API** — USPTO's bulk data download API is the official source feed; Marker provides a hosted search layer on top of similar data.
- **Clearbit** — Clearbit enriches company records with firmographic data that pairs with Marker's trademark filings under those owners.
- **FullContact** — FullContact resolves people and companies with rich profile data that complements Marker's trademark owner field.
- **Crunchbase** — Crunchbase exposes funding and company-profile data that pairs with Marker's trademark portfolio insight.

## FAQ

### Why is there no official OpenAPI spec for Marker Trademark Search API?

Marker does not publish a hosted OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Marker Trademark Search API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the Marker Trademark Search API use?

Marker requires a username and password issued at signup. Both values are passed as path parameters on every request (e.g. `/username/{username}/password/{password}`), which is unusual; Jentic stores them encrypted in your Jentic One instance and injects them at execution time so the agent never sees them in cleartext.

### Can I check whether a brand name is already trademarked?

Yes. GET `/trademarks/trademark/{searchTerm}/status/live/start/0/...` returns every live US trademark whose name matches the supplied term. Pair it with `/trademarks/description/{searchTerm}/status/live/...` to also catch matches inside the goods-and-services description.

### What are the rate limits for the Marker Trademark Search API?

The Marker spec does not document a per-second rate limit. Quotas are enforced at the account level and depend on the plan selected at signup; over-quota requests return an HTTP 403, so production callers should respect 4xx responses and back off.

### How do I find trademarks expiring soon through Jentic?

Run `pip install jentic`, search for 'find expiring US trademarks', load the schema for GET `/trademarks/expiration/{timeframe}/start/{start}/...`, and execute it with `timeframe` set to your renewal window (in days). Page through results by incrementing `start`.

### Can I search trademarks by owner name?

Yes. GET `/trademarks/owner/{ownerName}/status/{status}/start/{start}/...` returns every trademark filed under the owner name with the chosen status filter. Status accepts values such as `live`, `dead`, and `all`, and pagination uses the `start` parameter.

### Can I limit what my agent is allowed to do with the Marker Trademark Search API?

Yes. Because Jentic One is self-hosted, your own rules decide which Marker operations the agent may call, and every Marker endpoint is a read-only trademark search, so you scope by operation. You can allow only the searches the agent needs, such as searching by trademark name or by owner, or listing marks by expiration window, and leave the serial-number lookup or description search out. The agent can only invoke the operations you have explicitly permitted, and your stored username and password are injected at execution time so it never handles the credentials itself.