User

The Threads user endpoints allow you to retrieve a Threads user's posts, publishing limit, and profile. See Retrieve Threads Profiles for more information.

GET /{threads-user-id}/threads

Retrieve a paginated list of all Threads posts created by a user. See Retrieve a List of All a User's Threads for more information.

Parameters

NameDescription

access_token

string

Required.
Threads Graph API user access token.

threads-user-id

string

Required.
The path parameter of the Threads user identifier.

fields

string

Optional.
A comma-separated list of the fields to be returned.
Values: id (default), media_product_type, media_type, media_url, permalink, owner, username, text, timestamp, shortcode, thumbnail_url, children, is_quote_post, alt_text, link_attachment_url, has_replies, reply_audience

since

Optional.
Query string parameter representing the start date for retrieval (must be a Unix timestamp or a date/time representation parseable by strtotime();, the timestamp must be greater than or equal to 1688540400 and less than the until parameter).

until

Optional.
Query string parameter representing the end date for retrieval (must be a Unix timestamp or a date/time representation parseable by strtotime();, the timestamp must be less than or equal to the current timestamp and greater than the since parameter).

limit

Optional.
Query string parameter representing the maximum number of media objects or records requested to return, default is 25 and maximum is 100 (only non-negative numbers are allowed).

before

Optional. Query string parameter representing a cursor that can be used for pagination, both before and after parameters cannot be passed at the same time.

after

Optional.
Query string parameter representing a cursor that can be used for pagination, both before and after parameters cannot be passed at the same time.


GET /{threads-user-id}/threads_publishing_limit

Check the app user's current publishing rate limit usage. See Rate Limiting for more information.

Parameters

NameDescription

access_token

string

Required.
Threads Graph API user access token.

threads-user-id

string

Required.
The path parameter of the Threads user identifier.

fields

string

Optional.
A comma-separated list of the fields to be returned.
Values: quota_usage (default), config, reply_quota_usage, reply_config


GET /{threads-user-id}?fields=id,username,...

Retrieve profile information about a user on Threads. See Retrieve Threads Profiles for more information.

Parameters

NameDescription

access_token

string

Required.
Threads Graph API user access token.

threads-user-id

string

Required.
The path parameter of the Threads user identifier.

fields

string

Optional.
A comma-separated list of the fields to be returned.
Values: id (default), username, name, threads_profile_picture_url, threads_biography


GET /{threads-user-id}/replies

Retrieve a paginated list of all Threads replies created by a user. See Retrieve a List of All a User's Replies for more information.

Parameters

NameDescription

access_token

string

Required.
Threads Graph API user access token.

threads-user-id

string

Required.
The path parameter of the Threads user identifier.

fields

string

Optional.
A comma-separated list of the fields to be returned.
Values: id (default), media_product_type, media_type, media_url, permalink, username, text, timestamp, shortcode, thumbnail_url, children, is_quote_post, has_replies, root_post, replied_to, is_reply, is_reply_owned_by_me, reply_audience

since

Optional.
Query string parameter representing the start date for retrieval (must be a Unix timestamp or a date/time representation parseable by strtotime();, the timestamp must be greater than or equal to 1688540400 and less than the until parameter).

until

Optional.
Query string parameter representing the end date for retrieval (must be a Unix timestamp or a date/time representation parseable by strtotime();, the timestamp must be less than or equal to the current timestamp and greater than the since parameter).

limit

Optional.
Query string parameter representing the maximum number of media objects or records requested to return, default is 25 and maximum is 100 (only non-negative numbers are allowed).

before

Optional. Query string parameter representing a cursor that can be used for pagination, both before and after parameters cannot be passed at the same time.

after

Optional.
Query string parameter representing a cursor that can be used for pagination, both before and after parameters cannot be passed at the same time.