Mentions

Returns a list of public Threads media objects in which a Threads profile has been tagged by another Threads profile.

Permissions

The Threads Mentions API requires an appropriate access token and permissions based on the node you are targeting. While you are testing, you can easily generate tokens and grant your app permissions by using the Graph API Explorer.

• threads_basic — Required for making any calls to all Threads API endpoints.
• threads_manage_mentions — Required for making any calls to the mentions endpoint.

If your app has not been approved for advanced access for the threads_manage_mentions permission, only mentions made by a Threads tester on the app will be returned. After approval, other users' public posts will be returned.

Limitations

• Threads media objects created by private users will not be returned.

Retrieve Threads Mentions

Fields

Use the fields parameter to specify fields you want included on any returned Threads media objects.

Example Request

curl -s -X GET \
  https://graph.threads.net/<THREADS_USER_ID>/mentions?fields=<LIST_OF_FIELDS>&access_token=<ACCESS_TOKEN>

Example Response

A successful API call returns a JSON-formatted object containing Threads media objects.

{
  "<FIELD>":"<VALUE>",
  ...
}

Pagination

This edge supports cursor-based pagination so the response will include before and after cursors if the response contains multiple pages of data. Unlike standard cursor-based pagination, however, the response will not include previous or next fields, so you will have to use the before and after cursors to construct previous and next query strings manually in order to page through the returned data set.

Example Request

curl -s -X GET \
  https://graph.threads.net/17841405822304914/mentions?fields=id,username&access_token=EAADd...

Example Response

{
  "data": [
    {
      "id": "18038...",
      "username": "keldo..."
    },
    {
      "id": "17930...",
      "username": "ashla..."
    },
    {
      "id": "17931...",
      "username": "jaypo..."
    }
  ]
}