Skip to main content
GET
Look up posts for a handle, hashtag, or other term

Authorizations

Authorization
string
header
required

API key prefixed with jcr_. To obtain a key programmatically (no dashboard required), see POST /v1/authorize.

Query Parameters

term
string
required

The term to look up (handle, hashtag, or keyword), interpreted per term_type

Example:

"@nasa"

platforms
string
required

Comma-separated list of platforms to query. See the table above for the platforms this endpoint supports.

Example:

"Instagram,YouTube"

term_type
enum<string>

How to interpret term. When omitted it is auto-detected (#-prefixed → hashtag, otherwise username). Applied to every requested platform; a platform that doesn't support the given value returns an invalid_term_type error in meta.platforms. See the table above for valid values per platform.

Available options:
username,
hashtag,
channel,
mentions,
reviews
Example:

"channel"

cursor
string

Opaque pagination cursor(s) from a prior response's meta.platforms[].next_cursor. Comma-separate multiple cursors to continue several platforms at once. Each cursor encodes its own platform; cursors are matched to the platforms named in platforms, and a malformed cursor is reported as an invalid_cursor entry in meta.platforms without affecting the others. Omit on the first page.

Response

Posts fetched successfully

data
object[]
required
meta
object
required