Skip to main content
POST
/
api
/
uspto_trademarks
/
marks
/
search
/uspto_trademarks/marks/search
curl --request POST \
  --url https://api.anysite.io/api/uspto_trademarks/marks/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "keyword": "<string>",
  "count": 2,
  "timeout": 300,
  "sort": "relevance",
  "search_mode": "basic"
}
'
[
  {
    "serial_number": "<string>",
    "@type": "@uspto_trademarks_search_result",
    "registration_number": "<string>",
    "wordmark": "<string>",
    "status_code": 123,
    "status_description": "<string>",
    "is_alive": true,
    "is_registered": true,
    "filing_date": "<string>",
    "registration_date": "<string>",
    "abandon_date": "<string>",
    "cancel_date": "<string>",
    "first_use_date": "<string>",
    "first_use_in_commerce_date": "<string>",
    "mark_type": [],
    "mark_description": [],
    "is_standard_char_claimed": true,
    "drawing_code": "<string>",
    "design_codes": [],
    "international_classes": [],
    "us_classes": [],
    "goods_and_services": [],
    "disclaimer": "<string>",
    "current_basis": [],
    "owner_name": [],
    "owner_entity": [],
    "owner_citizenship": [],
    "owner_type": [],
    "image": "<string>"
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
keyword
string
required

Search keyword (matched against the wordmark)

Minimum string length: 1
​
count
integer
required

Max number of results

Required range: x >= 1
​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
status
enum<string> | null

Filter by trademark status — live, dead, registered, pending (live but not yet registered), abandoned, or cancelled

Available options:
live,
dead,
registered,
pending,
abandoned,
cancelled
​
nice_class
enum<string> | null

Filter by international (Nice) class, or 200 for US collective membership marks

Available options:
001,
002,
003,
004,
005,
006,
007,
008,
009,
010,
011,
012,
013,
014,
015,
016,
017,
018,
019,
020,
021,
022,
023,
024,
025,
026,
027,
028,
029,
030,
031,
032,
033,
034,
035,
036,
037,
038,
039,
040,
041,
042,
043,
044,
045,
200
​
sort
enum<string>
default:relevance

Result ordering

Available options:
relevance,
filing_date_desc,
filing_date_asc,
registration_date_desc,
registration_date_asc,
serial_number_asc,
serial_number_desc
​
search_mode
enum<string>
default:basic

Search scope — basic matches the wordmark, advanced also matches owner name, translation, and goods/services

Available options:
basic,
advanced

Response

Successful Response

​
serial_number
string
required
​
@type
string
default:@uspto_trademarks_search_result
​
registration_number
string | null
​
wordmark
string | null
​
status_code
integer | null
​
status_description
string | null
​
is_alive
boolean | null
​
is_registered
boolean | null
​
filing_date
string | null
​
registration_date
string | null
​
abandon_date
string | null
​
cancel_date
string | null
​
first_use_date
string | null
​
first_use_in_commerce_date
string | null
​
mark_type
string[]
​
mark_description
string[]
​
is_standard_char_claimed
boolean | null
​
drawing_code
string | null
​
design_codes
string[]
​
international_classes
string[]
​
us_classes
string[]
​
goods_and_services
string[]
​
disclaimer
string | null
​
current_basis
string[]
​
owner_name
string[]
​
owner_entity
string[]
​
owner_citizenship
string[]
​
owner_type
string[]
​
image
string | null