Открытый доступ

Таксономия ролей доступна по HTTP API и как JSON-файл в GitHub — по тому же принципу, что уPodcast Taxonomy.

Сейчас в каноне: 206 ролей в 22 группах.

Бесплатно для всех: без оплаты, ключей и регистрации; можно в коммерческих продуктах. Лицензия текстов —CC BY-SA 4.0: укажите авторство («Словарь подкастинга» + ссылка нарепозиторий); если публикуете свою переработанную версию датасета — тоже под CC BY-SA 4.0.

Для продакшена кэшируйте ответы у себя (например, на несколько часов или сутки).

HTTP API v1

База: /api/v1/. CORS открыт (Access-Control-Allow-Origin: *).

  • GET /api/v1/ — meta, счётчики, список эндпоинтов
  • GET /api/v1/roles — все роли; фильтр ?group=producing
  • GET /api/v1/roles/:code — одна роль (executiveProducer или kebab-slug)
  • GET /api/v1/groups — группы
  • GET /api/v1/groups/:slug — группа и её роли
  • GET /api/v1/search?q= — поиск по названию, aliases, описанию

Примеры

# meta
curl -s http://localhost:4321/api/v1/

# все роли в группе
curl -s 'http://localhost:4321/api/v1/roles?group=producing'

# одна роль
curl -s http://localhost:4321/api/v1/roles/executiveProducer

# поиск
curl -s 'http://localhost:4321/api/v1/search?q=продюсер'
const res = await fetch('/api/v1/search?q=editor');
const data = await res.json();
console.log(data.roles);

JSON в репозитории

Плоский массив ролей (совместим по полям с Podcast Taxonomy, плюсcode, enLabel, groupNameEn, aliases):

Сайт: podcasttaxonomy.ru

Репозиторий:github.com/Te1man/podcasttaxonomy

taxonomies/creator-roles.json

Можно скопировать файл в свой проект или подключать по raw URL (с кэшированием). Условия, пример атрибуции и полный текст лицензии — вREADME репозитория.