Mentions

Every reply, quote and mention of the connected X account, with the reply squidX or you already sent when there is one.

List mentions

GETsquidx.io/api/v1/mentionsmentions:read

Mentions of the connected account, newest first.

List mentions parameters
Name	In	Type	Description
`kind`	query	string	reply, quote or mention.
`status`	query	string	new or archived.
`unanswered`	query	boolean	true keeps only mentions with no reply yet.
`limit`	query	integer	Rows per page, 1 to 200. Default 50.
`offset`	query	integer	Rows to skip. Default 0. The response meta carries the total.

Request

curl "https://squidx.io/api/v1/mentions?unanswered=true&limit=10" \
  -H "Authorization: Bearer sqx_your_key"

Response · 200

{
  "data": [
    {
      "id": "e5f6a7b8-c9d0-4e1f-a2b3-c4d5e6f7a8b9",
      "postId": "1969900098765432109",
      "url": "https://x.com/janedoe/status/1969900098765432109",
      "kind": "reply",
      "text": "@aschapmann does this work with threads?",
      "postedAt": "2026-09-23T08:12:00.000Z",
      "status": "new",
      "author": {
        "username": "janedoe",
        "name": "Jane Doe",
        "avatarUrl": "https://pbs.twimg.com/profile_images/.../photo.jpg",
        "followers": 2310,
        "verified": false
      },
      "metrics": {
        "likes": 3,
        "replies": 1,
        "reposts": 0,
        "impressions": 410
      },
      "reply": null
    }
  ],
  "meta": {
    "total": 8,
    "limit": 10,
    "offset": 0
  }
}