GET /polls/:name/recommendations — tournesol-api

polls

List the recommended entities of a given poll sorted by decreasing total score.

get/polls/{name}/recommendations/

Path parameters

namestring required

Query parameters

limitinteger

Number of results to return per page.

offsetinteger

The initial index from which to return the results.

date_ltestring date-time

date_gtestring date-time

searchstring

A search query to filter entities

unsafeboolean

If true, entities considered as unsafe recommendations because of a low score or due to too few contributions will be included.

exclude_compared_entitiesboolean

If true and a user is authenticated, then entities compared by the user will be removed from the response

weightsobject

Weights for criteria in this poll. The default weight is 10 for each criteria.

metadataobject

Filter by one or more metadata.

score_mode'all_equal' | 'default' | 'trusted_only'

Response

countinteger required

nextstring uri nullable

previousstring uri nullable

Example response

{
  "count": 123,
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100"
}

Changes

Changed in 8 of the 50 revisions of this API.17325

Dec 19, 20243bba1a8d66512See the full diff
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
Nov 30, 2023834066e5d79511See the full diff
- ●
  added the new moderation_by_contributors enum value to the ///////////// response property for the response status
  response-property-enum-value-added
- ○
  added the required property // to the response with the status
  response-required-property-added
Nov 22, 20238e45c6d6f2481See the full diff
- ●
  added the new moderation_by_association enum value to the ///////////// response property for the response status
  response-property-enum-value-added
Sep 28, 20239671427c6f2e93See the full diff
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
Aug 24, 20235605b608cade29See the full diff
- ▲
  the // response property's maxLength was unset from 144 for the response status
  response-property-max-length-unset
- ▲
  the // response's property type changed from string to no type for status
  response-property-type-changed
- ○
  the response optional property // became read-only for the status
  response-optional-property-became-read-only
- ○
  the response optional property // became read-only for the status
  response-optional-property-became-read-only
- ○
  added to the // response property allOf list for the response status
  response-property-all-of-added
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  removed the candidate_fr_2022 enum value from the // response property for the response status
  response-property-enum-value-removed
- ○
  removed the video enum value from the // response property for the response status
  response-property-enum-value-removed
- ○
  the response required property // became read-only for the status
  response-required-property-became-read-only
- ○
  the response required property // became read-only for the status
  response-required-property-became-read-only
Aug 6, 20231e267e561ebb1See the full diff
- ○
  added the new optional query request parameter exclude_compared_entities
  new-optional-request-parameter
Jul 25, 20232b1b5960cdcd1See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
Jul 4, 2023b0f74d913a83618See the full diff
- ▲
  the response property became optional for the status
  response-property-became-optional
- ▲
  the response property became optional for the status
  response-property-became-optional
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ●
  deleted the query request parameter exclude_compared_entities
  request-parameter-removed
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
This revision also has 31 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history