Expertises | TextMaster's Developer Documentation

TextMaster's Developer Documentation

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.

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).

Code samples

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

Get a sub-expertise

Code samples

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

List Expertises

get

Query parameters

filterstring · enumRequired

(required) Type of abilities to list.

Possible values:

professional
interest

Possible values:

localestringOptional

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

Responses

200

Lists expertises

application/json

get

GET /v1/public/expertises HTTP/1.1
Host: api.textmaster.com
Accept: */*

200

Lists expertises

[
  {
    "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
    }
  }
]

List Sub-Expertises

get

Path parameters

expertise_idstringRequired

(required) The parent Expertise ID

Query parameters

localestringOptional

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

Responses

200

Lists Sub-Expertises

application/json

404

Not found

get

GET /v1/public/expertises/{expertise_id}/sub_expertises HTTP/1.1
Host: api.textmaster.com
Accept: */*

[
  {
    "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
    }
  }
]

Retrieve a single Sub-Expertise

get

Path parameters

expertise_idstringRequired

(required) The parent Expertise ID

sub_expertise_idstringRequired

(required) The Sub-Expertise ID

Query parameters

localestringOptional

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

Responses

200

Lists Sub-Expertises

application/json

404

Not found

get

GET /v1/public/expertises/{expertise_id}/sub_expertises/{sub_expertise_id} HTTP/1.1
Host: api.textmaster.com
Accept: */*

{
  "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
  }
}