Discovery

Note

These v4 APIs are now frozen. See the API versions available for details of the different API versions available.

Discovery Content

This endpoint allows you to fetch content for the new Discovery Pane in Firefox (about:addons).

Note

A standard discovery pane will display 7 items, 4 extensions and 3 themes.

GET /api/v4/discovery/
Query Parameters:

  • lang (string) – Activates translations. (See translated fields)

  • edition (string) – Optionally return content for a specific edition of Firefox. Currently only china (and the alias MozillaOnline) is supported.

  • telemetry-client-id (string) – Ignored. Was previously an optional sha256 hash of the telemetry client ID to be passed to the TAAR service to enable recommendations.

Response JSON Object:

  • count (int) – The number of results for this query.

  • results (array) – The array containing the results for this query.

  • results[].description_text (string|null) – The description for this item, if any. Text-only, content might slightly differ from description because of that.

  • results[].is_recommendation (boolean) – Always False.

  • results[].addon (object) – The add-on for this item. Only a subset of fields are present: id, authors, average_daily_users, current_version (with only the id, compatibility, is_strict_compatibility_enabled and files fields present), guid, icon_url, name, ratings, previews, slug, theme_data, type and url.

Editorial Content

This endpoint allows you to fetch all editorial content for Discovery Pane Recommendations. This is used internally to generate .po files containing the strings defined by the content team.

GET /api/v4/discovery/editorial/
Query Parameters:

  • recommended (boolean) – Filter to only add-ons recommended by Mozilla. Only recommended=true is supported.

Response JSON Object:

  • results (array) – The array containing the results for this query. There is no pagination, all results are returned.

  • results[].addon (object) – A add-on object for this item, but only containing one field: guid.

  • results[].custom_description (string|null) – The custom description for this item, if any.