TextMaster's Developer Documentation
HomeApp
  • Welcome!
  • Quick Start
    • Postman
    • OpenAPI
  • Overview
    • Resources in the REST API
    • Authentication
    • Troubleshooting
    • Filters
    • Workflow
    • File uploads
    • Loop
  • Guides
    • Integrator best practices
  • Apps
    • About OAuth Apps
    • Building OAuth Apps
      • Creating an OAuth App
      • Authorizing OAuth Apps
      • Scopes for OAuth Apps
    • Managing OAuth Apps
      • Modifying an OAuth App
      • Deleting an OAuth App
  • Webhooks & Events
    • Webhooks
      • Creating webhooks
      • Configuring your server for webhooks
      • Securing webhooks
      • Troubleshooting webhooks
    • Events
  • Integrations
    • Akeneo
      • Getting Started
      • Configuration
      • Usage
      • Monitoring
      • Troubleshooting
    • Salesforce Commerce Cloud
      • Getting Started
      • Configuration
      • Usage
      • Monitoring
      • Troubleshooting
  • Reference
    • Abilities
    • Authors
    • Documents
    • Categories
    • Countries
    • Expertises
    • Glossaries
    • Languages
    • Levels
    • Locales
    • Preferred Authors
    • Projects
    • Project Templates
    • Negotiated Contracts
    • Support Messages
    • Transactions
    • Uploads
    • Users
    • Work Templates
Powered by GitBook
On this page

Was this helpful?

  1. Reference

Expertises

PreviousCountriesNextGlossaries

Last updated 1 year ago

Was this helpful?

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
  }
}
  • List expertises
  • GETList Expertises
  • List sub-expertises
  • GETList Sub-Expertises
  • Get a sub-expertise
  • GETRetrieve a single Sub-Expertise