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.
openapi: 3.2.0
info:
title: MarketMan API V3 Authentication API
description: MarketMan provides a JSON REST API for integration with third-party applications such as accounting, ERP, e-commerce, and self-service portals.
termsOfService: https://www.marketman.com/
contact:
name: MarketMan
url: https://www.marketman.com/
version: '3.0'
servers:
- url: https://api.marketman.com/v3
description: MarketMan API V3 production base URL
security:
- AuthToken: []
tags:
- name: Authentication
description: Token acquisition and token status.
paths:
/buyers/auth/GetToken:
post:
operationId: getToken
tags:
- Authentication
summary: Obtain an access token
description: Exchanges an APIKey and APIPassword for an access Token used in the AUTH_TOKEN header on all subsequent requests.
security: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/GetTokenRequest'
responses:
'200':
description: Authentication result with a token on success.
content:
application/json:
schema:
$ref: '#/components/schemas/GetTokenResponse'
/buyers/auth/GetTokenDetails:
post:
operationId: getTokenDetails
tags:
- Authentication
summary: Get details about the current token
responses:
'200':
description: Token details.
content:
application/json:
schema:
type: object
components:
schemas:
GetTokenRequest:
type: object
required:
- APIKey
- APIPassword
properties:
APIKey:
type: string
description: API key issued by MarketMan support.
APIPassword:
type: string
description: API password issued by MarketMan support.
GetTokenResponse:
type: object
properties:
Token:
type: string
description: Access token to send in the AUTH_TOKEN header.
IsSuccess:
type: boolean
ErrorMessage:
type:
- string
- 'null'
securitySchemes:
AuthToken:
type: apiKey
in: header
name: AUTH_TOKEN
description: Access token returned by GetToken, sent on every authenticated request in the AUTH_TOKEN header.