List top comments for an individual user

Retrieve the top user comments in a given time period

Headers
string
required

Unique OpenWeb engagement token

Follow these steps to obtain the engagement token:

  1. From your OpenWeb Admin Dashboard, click Settings.
  2. Under Authentication Tokens, copy the Engagement value.
NOTE: This value must not be exposed to users.

string
required

Spot ID of the partner

string
required

ID for the user who wrote the comments

integer
Defaults to 10

Number of comments to return

string
enum
Defaults to two-months

Period of time to return comments

Allowed:
integer
1 to 12

Number of the month within the x-year in which comments were posted

The x-month and x-interval values determines the duration of comments returned:

  • If x-month = 3 and x-interval = one-month, the API returns comments posted in March (month 3 of the year).
  • If x-month = 3 and x-interval = two-months (default), the API returns comments posted in March (month 3 of the year) and February (the previous month).

Default Value: The month number of the current month.

string

Number of the week within the x-month of the x-year in which comments were posted

The x-weeks and x-interval values determine the duration of comments returned:

  • If x-weeks = 3 and x-interval = one-week, the API returns comments posted in week 3 of the month of the year.
  • If x-weeks = 3,4 and x-interval = two-weeks, the API returns comments posted in weeks 3 and 4 of the month of the year.

NOTES:

  • If x-interval = two-weeks, the x-weeks value must be defined as two consecutive weeks separated by a comma, 3,4.
  • If x-interval = one-month or two-months, the x-weeks value is ignored.
integer

Year of the time range

The current year is the default value.

Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json