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

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

/v1/public/expertises

HTTPcURLJavaScriptPython

GET /v1/public/expertises?filter=professional 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
    }
  }
]

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

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

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

HTTPcURLJavaScriptPython

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
    }
  }
]

Code samples

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

Get a sub-expertise

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

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

HTTPcURLJavaScriptPython

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

Code samples

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