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
filterenumrequired

(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
curl -L \
  --url 'https://api.textmaster.com/v1/public/expertises?filter=professional'
[
  {
    "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

/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
curl -L \
  --url 'https://api.textmaster.com/v1/public/expertises/{expertise_id}/sub_expertises'
[
  {
    "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

/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
curl -L \
  --url 'https://api.textmaster.com/v1/public/expertises/{expertise_id}/sub_expertises/{sub_expertise_id}'
{
  "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"

Last updated

Was this helpful?