Get sales figures
get_sales_figuresGet the sales figures of a series. Returns {series_id, url, figures, cells, region_totals, coverage, lifetime}. figures are the rows as published, each with units, the source's own wording, the period, source_url and a verbatim source_excerpt. cells are the grid a figure may be summed into, one per series, country and calendar year; a null units on a cell means the sources disagree, never zero sold. region_totals sum years within one country only, so never add across countries or add a parent region to its children. coverage rows are the blanks that were checked and found empty, with the reason. lifetime rows are cumulative or per-generation totals that must not be added to the grid. A model_id narrows figures only, since allocating a year to a generation needs the whole series. An empty list means not researched yet, never zero.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model_id | No | Generation (model) id (a UUID from search_vehicles). Takes precedence over series_id when both are given. | |
| series_id | No | Series id (a UUID from search_vehicles). |