find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/ecommercedataapi-com:ecommercedataapi-com-global-trademarks-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Ecommerce Data Global Trademarks API
  version: 1.0.0
  description: Amazon ecommerce data APIs for product research, keyword intelligence, market analytics, sales, reviews, traffic, trademarks, and automation.
servers:
- url: https://ecommercedataapi.com
  description: Production
security:
- ApiKeyAuth: []
- BearerAuth: []
tags:
- name: Global Trademarks
paths:
  /v1/global/brand/stats:
    post:
      operationId: globalTrademarksStatistics
      summary: Global Trademark Statistics
      description: Retrieve aggregate trademark statistics by office and query text.
      tags:
      - Global Trademarks
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GlobalTrademarksStatisticsRequest'
            example:
              office:
              - US
              text: ANKER
      responses:
        '200':
          $ref: '#/components/responses/GlobalTrademarksStatisticsSuccess'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '413':
          $ref: '#/components/responses/RequestTooLarge'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
        '502':
          $ref: '#/components/responses/BadGateway'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
        '504':
          $ref: '#/components/responses/GatewayTimeout'
  /v1/global/brand/list:
    post:
      operationId: globalTrademarksSearch
      summary: Global Trademark Search
      description: Search trademark records across supported intellectual property offices.
      tags:
      - Global Trademarks
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GlobalTrademarksSearchRequest'
            example:
              office:
              - US
              text: ANKER
              status:
              - Registered
              order:
                field: applicationDate
                desc: true
              page: 1
              size: 20
      responses:
        '200':
          $ref: '#/components/responses/GlobalTrademarksSearchSuccess'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '413':
          $ref: '#/components/responses/RequestTooLarge'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
        '502':
          $ref: '#/components/responses/BadGateway'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
        '504':
          $ref: '#/components/responses/GatewayTimeout'
  /v1/global/brand/detail:
    post:
      operationId: globalTrademarksDetails
      summary: Global Trademark Details
      description: Retrieve a trademark record by office and identifier.
      tags:
      - Global Trademarks
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GlobalTrademarksDetailsRequest'
            example:
              office: US
              brandId: US502022097612203
      responses:
        '200':
          $ref: '#/components/responses/GlobalTrademarksDetailsSuccess'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '413':
          $ref: '#/components/responses/RequestTooLarge'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
        '502':
          $ref: '#/components/responses/BadGateway'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
        '504':
          $ref: '#/components/responses/GatewayTimeout'
  /v1/global/brand/range:
    post:
      operationId: globalTrademarksCoverage
      summary: Global Trademark Data Coverage
      description: List supported trademark offices and countries.
      tags:
      - Global Trademarks
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GlobalTrademarksCoverageRequest'
            example: {}
      responses:
        '200':
          $ref: '#/components/responses/GlobalTrademarksCoverageSuccess'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '413':
          $ref: '#/components/responses/RequestTooLarge'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
        '502':
          $ref: '#/components/responses/BadGateway'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
        '504':
          $ref: '#/components/responses/GatewayTimeout'
components:
  schemas:
    GlobalTrademarksDetailsRequest:
      type: object
      properties:
        office:
          type: string
          examples:
          - US
          description: Trademark office or list of trademark offices.
        brandId:
          type: string
          examples:
          - US502022097612203
          description: Trademark record identifier returned by the search endpoint.
        returnFields:
          type: string
          examples:
          - id,applicant,applicantCountryCode
          description: Optional comma-separated response fields. Omit it to receive the standard payload.
      required:
      - office
      - brandId
      additionalProperties: false
    GatewayError:
      type: object
      required:
      - request_id
      - error
      properties:
        request_id:
          type: string
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: string
            message:
              type: string
            details: {}
          additionalProperties: false
      additionalProperties: false
    GatewaySuccess:
      type: object
      required:
      - request_id
      - data
      properties:
        request_id:
          type: string
          format: uuid
        data: {}
      additionalProperties: false
    GlobalTrademarksCoverageRequest:
      type: object
      properties: {}
      required: []
      additionalProperties: false
    GlobalTrademarksSearchRequest:
      type: object
      properties:
        applicant:
          type: array
          items:
            type: string
            description: Applicant.
          examples:
          - - ANKER INC
          description: Applicant.
        applicationYear:
          type: array
          items:
            type: string
            description: Application year.
          examples:
          - - '1985'
          description: Application year.
        brandName:
          type: array
          items:
            type: string
            description: Brand name.
          examples:
          - - ADVENTURE CLUB
          description: Brand name.
        expiryYear:
          type: array
          items:
            type: string
            description: Expiry year.
          examples:
          - - '2026'
          description: Expiry year.
        imageBase64:
          type: string
          examples:
          - Image base64
          description: Image base64.
        niceClass:
          type: array
          items:
            type: integer
            format: int32
            description: Nice class.
          examples:
          - - 5
          description: Nice class.
        office:
          type: array
          items:
            type: string
            description: Trademark office or list of trademark offices.
          examples:
          - - US
          description: Trademark office or list of trademark offices.
        order:
          type: object
          properties:
            desc:
              type: boolean
              examples:
              - true
              description: Use true for descending order or false for ascending order.
            field:
              type: string
              examples:
              - searches
              description: Field used to sort the results.
          additionalProperties: false
          examples:
          - {}
          description: Sort definition.
        page:
          type: integer
          format: int32
          minimum: 1
          examples:
          - 1
          description: Page number starting at 1.
        returnFields:
          type: string
          examples:
          - id,applicant,applicantCountryCode
          description: Optional comma-separated response fields. Omit it to receive the standard payload.
        size:
          type: integer
          format: int32
          minimum: 1
          examples:
          - 20
          description: Number of results per page.
        status:
          type: array
          items:
            type: string
            description: Status.
          examples:
          - - Registered
          description: Status.
        text:
          type: string
          examples:
          - CHINESE
          description: Text used by the query.
      required:
      - text
      additionalProperties: false
    GlobalTrademarksStatisticsRequest:
      type: object
      properties:
        office:
          type: array
          items:
            type: string
            description: Trademark office or list of trademark offices.
          examples:
          - - US
          description: Trademark office or list of trademark offices.
        returnFields:
          type: string
          examples:
          - office,brandName,status
          description: Optional comma-separated response fields. Omit it to receive the standard payload.
        text:
          type: string
          examples:
          - CHINESE
          description: Text used by the query.
      required:
      - office
      - text
      additionalProperties: false
  responses:
    BadGateway:
      description: The data service returned an invalid response.
      headers:
        X-Request-ID:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GatewayError'
    BadRequest:
      description: The request body or parameters are invalid.
      headers:
        X-Request-ID:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GatewayError'
    GlobalTrademarksSearchSuccess:
      description: Global Trademark Search response.
      headers:
        X-Request-ID:
          $ref: '#/components/headers/RequestId'
        X-RateLimit-Limit:
          $ref: '#/components/headers/RateLimitLimit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/RateLimitRemaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/RateLimitReset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GatewaySuccess'
          example:
            request_id: 8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8
            data:
              pages: 1
              page: 1
              size: 20
              total: 1
              items:
              - id: US502022097612203
                applicant:
                - ANKER INC
                applicantCountryCode: US
                applicants:
                - kind: Legal Entity
                  identifier: '33744042'
                  countryCode: US
                  contact: {}
                  fullAddress:
                  - text: Text example
                    languageCode: en
                    imageUrl: Image URL example
                  fullName:
                  - text: ANKER INC
                    languageCode: en
                applicationDate: '2022-09-29'
                applicationLanguageCode: en
                applicationNumber: '97612203'
                registrationNumber: '4590785'
                applicationRefNumber: []
                brandName:
                - 1ST AID
                collection: ustm
                designatedCountries:
                - US
                designation:
                - US
                filingPlace: Filing place example
                kind:
                - Individual
                logos:
                - logo: Logo example
                  logoUrl: Logo URL example
                markFeature: Combined
                niceClass:
                - 5
                office: US
                status: Pending
                statusDate: '2023-05-02'
                type: TRADEMARK
    PaymentRequired:
      description: The account does not have enough Credits for this request.
      headers:
        X-Request-ID:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GatewayError'
    GlobalTrademarksDetailsSuccess:
      description: Global Trademark Details response.
      headers:
        X-Request-ID:
          $ref: '#/components/headers/RequestId'
        X-RateLimit-Limit:
          $ref: '#/components/headers/RateLimitLimit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/RateLimitRemaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/RateLimitReset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GatewaySuccess'
          example:
            request_id: 8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8
            data:
              id: US502022097612203
              applicant:
              - ANKER INC
              applicantCountryCode: US
              applicants: []
              applicationDate: '2022-09-29'
              applicationLanguageCode: en
              applicationNumber: '97612203'
              registrationNumber: '4590785'
              applicationRefNumber: []
              brandName:
              - 1ST AID
              collection: ustm
              designatedCountries:
              - US
              designation:
              - US
              filingPlace: Filing place example
              kind:
              - Individual
              logos:
              - logo: Logo example
                logoUrl: Logo URL example
              markFeature: Combined
              niceClass:
              - 5
              office: US
              status: Pending
              statusDate: '2023-05-02'
              type: TRADEMARK
              appeals:
              - date: Date example
                kind: Kind example
              correspondence: Correspondence example
              events:
              - date: Date example
                officeKind: Office kind example
                gbdKind: Gbd kind example
                doc: Doc example
                country: Country example
              expiryDate: Expiry date example
              extra: Extra example
              gbdStatus: Gbd status example
              goodsServicesClassification:
                kind: Kind example
                version: Version example
                classification:
                  code: Code example
                  terms: Terms example
              goodsServicesUnclassified: Goods services unclassified example
              markDescriptionDetails:
              - text: ANKER INC
                languageCode: en
              markDisclaimerDetails:
              - text: ANKER INC
                languageCode: en
              markImageDetails: []
              nationalGoodsServicesClassification:
                kind: Kind example
                version: Version example
                classification:
                  code: Code example
                  terms: Terms example
              officeStatus: Office status example
              priorities:
              - severity: Severity example
                code: Code example
                field: Field example
                type: Type example
                message: Message example
              publicationDate: Publication date example
              publications:
              - date: Date example
                identifier: Identifier example
                section: Section example
              qc:
              - severity: Severity example
                code: Code example
                field: Field example
                type: Type example
                message: Message example
              reference:
                office: Office example
                application:
                  date: Date example
                  number: Number example
                registration:
                  date: Date example
                  number: Number example
              refOffice: Ref office example
              registrationDate: Registration date example
              registrationOfficeCode: Registration office code example
              registrationRefNumber: []
              representatives: []
              secondLanguageCode: Second language code example
              st13: St13 example
              terminationDate: Termination date example
              wordMarkSpecification:
                markTransliteration: Mark transliteration example
                markTranslation:
                  text: Text example
                  languageCode: Language code example
                markVerbalElement:
                  text: Text example
                  languageCode: Language code example
                markSignificantVerbalElement:
                  text: SONICARE
                  languageCode: en
    RateLimited:
      description: The request limit was exceeded.
      headers:
        X-Request-ID:
          $ref: '#/components/headers/RequestId'
        Retry-After:
          $ref: '#/components/headers/RetryAfter'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GatewayError'
    Forbidden:
      description: The subscription does not include this endpoint.
      headers:
        X-Request-ID:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GatewayError'
    GlobalTrademarksCoverageSuccess:
      description: Global Trademark Data Coverage response.
      headers:
        X-Request-ID:
          $ref: '#/components/headers/RequestId'
        X-RateLimit-Limit:
          $ref: '#/components/headers/RateLimitLimit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/RateLimitRemaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/RateLimitReset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GatewaySuccess'
          example:
            request_id: 8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8
            data:
            - office: YT
              officeLabel: Mayotte
            - office: ZA
              officeLabel: South Africa
    InternalError:
      description: An internal error occurred.
      headers:
        X-Request-ID:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GatewayError'
    GlobalTrademarksStatisticsSuccess:
      description: Global Trademark Statistics response.
      headers:
        X-Request-ID:
          $ref: '#/components/headers/RequestId'
        X-RateLimit-Limit:
          $ref: '#/components/headers/RateLimitLimit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/RateLimitRemaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/RateLimitReset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GatewaySuccess'
          example:
            request_id: 8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8
            data:
              office:
              - key: US
                count: 2
              brandName:
              - key: ADVENTURE CLUB
                count: 4
              status:
              - key: Registered
                count: 12
              applicant:
              - key: ANKER INC
                count: 4
              niceClass:
              - key: '5'
                count: 2
                label: Pharmaceuticals
              applicationYear:
              - key: '1985'
                count: 5
              expiryYear:
              - key: '2026'
                count: 2
    NotFound:
      description: The endpoint does not exist.
      headers:
        X-Request-ID:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GatewayError'
    RequestTooLarge:
      description: The request body is too large.
      headers:
        X-Request-ID:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GatewayError'
    ServiceUnavailable:
      description: The data service is temporarily unavailable.
      headers:
        X-Request-ID:
          $ref: '#/components/headers/RequestId'
        Retry-After:
          $ref: '#/components/headers/RetryAfter'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GatewayError'
    Unauthorized:
      description: Authentication failed.
      headers:
        X-Request-ID:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GatewayError'
    GatewayTimeout:
      description: The data service timed out.
      headers:
        X-Request-ID:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GatewayError'
  headers:
    RequestId:
      description: Request identifier.
      schema:
        type: string
    RateLimitRemaining:
      description: Requests remaining in the active minute window.
      schema:
        type: integer
    RateLimitLimit:
      description: Requests allowed in the active minute window.
      schema:
        type: integer
    RetryAfter:
      description: Seconds to wait before retrying.
      schema:
        type: integer
    RateLimitReset:
      description: Window reset time as a Unix timestamp in seconds.
      schema:
        type: integer
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Ecommerce Data API key.
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Ecommerce Data API key