Add a widget to a report page
Add a new widget to a report page at the specified grid position. widget_type must be one of: stat_card, line_chart, bar_chart, donut_chart, table, text. data_source identifies which SEO dataset powers the widget (e.g., ‘ranking_overview’, ‘backlink_summary’). Static widgets such as ‘text’ do not require a data_source.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Path Parameters
Body
Request body for adding a new widget to a report page.
Type of widget to render. One of: stat_card, line_chart, bar_chart, donut_chart, table, text.
Display title shown in the widget header.
1 - 255Identifier for the data source powering this widget (e.g., 'ranking_overview', 'backlink_summary'). Null for static widgets such as 'text'.
Widget-specific configuration object (metrics to display, chart colours, table columns, text content, etc.).
Horizontal grid position (column index, 0-based).
Vertical grid position (row index, 0-based).
Width of the widget in grid columns (1–3).
1 <= x <= 3Height of the widget in grid rows (1–2).
1 <= x <= 2