Historical series for one niche, grouped by item

Grouped by ITEM, not by window. A window is how the archive stores; an item with a series is how the question is asked. Capped at 5000 series points and a 90-day span, both enforced in the database. When the cap is hit, truncated is true and the series is incomplete — narrow the interval rather than drawing conclusions from a partial series.

An unknown niche is NOT a 404: nothing validates the name, so a typo returns items: [] with points: 0 — AND still spends a call, because the quota counter increments before the archive is read. Resolve niche names at /api/v1/nichos first.

get/api/v1/trends/{niche}

Request

  • Base URL: https://honesthook.com
  • URL: https://honesthook.com/api/v1/trends/{niche}
  • Auth: HTTP bearer

Path parameters

nichestring required

Query parameters

fromstring date-time

ISO 8601. Defaults to 7 days ago.

tostring date-time

ISO 8601. Defaults to now.

limitinteger

Hint only. The hard cap lives in the database and a larger value here does not raise it.

Response

OK

nichestring
fromstring date-time
tostring date-time
pointsinteger
truncatedboolean
credits_chargedinteger
paid_from'free' | 'balance'

Which pocket paid: the monthly free allowance or purchased credits.

free_usedinteger
free_totalinteger
credits_balanceinteger

Example response

{
  "items": [
    {
      "platform": "hackernews"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.