Expertises

List expertises

Public endpoint to list all available expertises supported by TextMaster.

Expertises allow clients to create projects that will only be available to authors with expert skills in a given area. Author expertises are validated by TextMaster's community managers in order to allow verified experts to work on sensible projects.

Expertises are scoped by activity, meaning that the copywriting activity has a different expertise set than the translation and proofreading activities.

List Expertises

get

/v1/public/expertises

Query parameters

filterstring · enumrequired

(required) Type of abilities to list.

Possible values:

• professional
• interest

Options: professional, interest

localestring

Locale used to translate the expertises name (en by default)

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.textmaster.com/v1/public/expertises?filter=professional'

200

200

[
  {
    "id": "596da90cc4f05c000170ffd0",
    "name": "Arts & Culture",
    "general_label": "General",
    "code": "arts_and_culture",
    "kind": "professional",
    "is_root": true,
    "client_pricing": 40,
    "client_pricing_in_currency": 0.04,
    "client_pricings": {
      "translation": 40,
      "copywriting": 100
    },
    "client_pricings_in_currency": {
      "translation": 0.04,
      "copywriting": 0.1
    }
  },
  {
    "id": "57ce805b39775e0003e221fe",
    "name": "Economics & Research",
    "general_label": "General",
    "code": "economics_and_research",
    "kind": "professional",
    "is_root": true,
    "client_pricing": 40,
    "client_pricing_in_currency": 0.04,
    "client_pricings": {
      "translation": 40,
      "copywriting": 100
    },
    "client_pricings_in_currency": {
      "translation": 0.04,
      "copywriting": 0.1
    }
  }
]

Lists expertises

Code samples

curl -G "https://api.textmaster.com/v1/public/expertises" \
  --data-urlencode "filter=professional"

List sub-expertises

Public endpoint to list all available sub-expertises supported by TextMaster.

An expertise can have one or more sub-expertise(s), they can be seen as a refinements of the subject described by the expertise (ex: Finance → Banking or Finance → Equity Markets).

List Sub-Expertises

get

/v1/public/expertises/{expertise_id}/sub_expertises

Path parameters

expertise_idstringrequired

(required) The parent Expertise ID

Query parameters

localestring

Locale used to translate the Sub-Expertises name (en by default)

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.textmaster.com/v1/public/expertises/{expertise_id}/sub_expertises'

200

404

200

[
  {
    "id": "57ce805b39775e0003e221e6",
    "name": "Automotive",
    "general_label": "General",
    "code": "automotive",
    "kind": "professional",
    "is_root": false,
    "client_pricing": 40,
    "client_pricing_in_currency": 0.04,
    "client_pricings": {
      "translation": 40,
      "copywriting": 100
    },
    "client_pricings_in_currency": {
      "translation": 0.04,
      "copywriting": 0.1
    }
  },
  {
    "id": "57ce805b39775e0003e221ef",
    "name": "Energy & Natural Resources",
    "general_label": "General",
    "code": "energy_and_natural_resources",
    "kind": "professional",
    "is_root": false,
    "client_pricing": 40,
    "client_pricing_in_currency": 0.04,
    "client_pricings": {
      "translation": 40,
      "copywriting": 100
    },
    "client_pricings_in_currency": {
      "translation": 0.04,
      "copywriting": 0.1
    }
  }
]

Lists Sub-Expertises

Code samples

curl "https://api.textmaster.com/v1/public/expertises/61698b008b81926d91c0f779/sub_expertises"

Get a sub-expertise

Retrieve a single Sub-Expertise

get

/v1/public/expertises/{expertise_id}/sub_expertises/{sub_expertise_id}

Path parameters

expertise_idstringrequired

(required) The parent Expertise ID

sub_expertise_idstringrequired

(required) The Sub-Expertise ID

Query parameters

localestring

Locale used to translate the Sub-Expertise name (en by default)

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.textmaster.com/v1/public/expertises/{expertise_id}/sub_expertises/{sub_expertise_id}'

200

404

200

{
  "id": "57ce805b39775e0003e221e6",
  "name": "Automotive",
  "general_label": "General",
  "code": "automotive",
  "kind": "professional",
  "is_root": false,
  "client_pricing": 40,
  "client_pricing_in_currency": 0.04,
  "client_pricings": {
    "translation": 40,
    "copywriting": 100
  },
  "client_pricings_in_currency": {
    "translation": 0.04,
    "copywriting": 0.1
  }
}

Lists Sub-Expertises

Code samples

curl "https://api.textmaster.com/v1/public/expertises/61698b008b81926d91c0f770/sub_expertises/61698b008b81926d91c0f773"