Api Endpoint

botsmith

X Account Dossier ($0.05/call): Full X (Twitter) account dossier in one call: profile, an analysis of recent posts (cadence, average engagement, reply/retweet/link share, top hashtags and mentions), the raw recent posts, and a transparent bot-likelihood signal with the evidence behind it. Composes profile + activity so an agent vetting an account does not have to. No X account or API key needed.

Open interactive test console

Offering

Provider
x402.botsmith.dev
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Social Intelligence
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://x402.botsmith.dev/x/dossier
MIME type
application/json
First seen
2026-10-16T01:50:14.534Z
Last seen
Tags
x, Twitter, Social, Dossier, intel, bot-detection

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.05 USDC
Atomic price: 50000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "50000",
    "payTo": "0xcb9b3F94387389e38EF2A7b3C0B851FB8325d7e9"
  }
]

Observed health

Status
Healthy
Latest latency
1441 ms
Average latency
1743 ms
HTTP status
402
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "handle": {
          "type": "string",
          "pattern": "^@?[A-Za-z0-9_]{1,15}$",
          "description": "X handle, with or without the leading @"
        },
        "sampleSize": {
          "default": 20,
          "description": "How many recent posts to analyze (max 20)",
          "type": "integer",
          "minimum": 1,
          "maximum": 20
        }
      },
      "required": [
        "handle",
        "sampleSize"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "additionalProperties": false,
          "properties": {
            "handle": {
              "description": "X handle, with or without the leading @",
              "pattern": "^@?[A-Za-z0-9_]{1,15}$",
              "type": "string"
            },
            "sampleSize": {
              "default": 20,
              "description": "How many recent posts to analyze (max 20)",
              "maximum": 20,
              "minimum": 1,
              "type": "integer"
            }
          },
          "required": [
            "handle",
            "sampleSize"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "additionalProperties": false,
          "properties": {
            "activity": {
              "additionalProperties": false,
              "properties": {
                "avgLikes": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "avgReplies": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "avgRetweets": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "postsPerDay": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "replyShare": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Fraction of sampled posts that are replies"
                },
                "retweetShare": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "sampleSize": {
                  "maximum": 9007199254740991,
                  "minimum": -9007199254740991,
                  "type": "integer"
                },
                "spanDays": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Days between oldest and newest sampled post"
                },
                "topHashtags": {
                  "items": {
                    "additionalProperties": false,
                    "properties": {
                      "count": {
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "type": "integer"
                      },
                      "tag": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "tag",
                      "count"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                },
                "topMentions": {
                  "items": {
                    "additionalProperties": false,
                    "properties": {
                      "count": {
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "type": "integer"
                      },
                      "handle": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "handle",
                      "count"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                },
                "withLinksShare": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "sampleSize",
                "spanDays",
                "postsPerDay",
                "avgLikes",
                "avgRetweets",
                "avgReplies",
                "replyShare",
                "retweetShare",
                "withLinksShare",
                "topHashtags",
                "topMentions"
              ],
              "type": "object"
            },
            "authenticity": {
              "additionalProperties": false,
              "properties": {
                "botLikelihood": {
                  "enum": [
                    "low",
                    "medium",
                    "high",
                    "unknown"
                  ],
                  "type": "string"
                },
                "flags": {
                  "description": "Transparent evidence behind the signal",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                }
              },
              "required": [
                "botLikelihood",
                "flags"
              ],
              "type": "object"
            },
            "profile": {
              "additionalProperties": false,
              "properties": {
                "accountAgeDays": {
                  "anyOf": [
                    {
                      "maximum": 9007199254740991,
                      "minimum": -9007199254740991,
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "bio": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "createdAt": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "ISO 8601 account creation time"
                },
                "followers": {
                  "anyOf": [
                    {
                      "maximum": 9007199254740991,
                      "minimum": -9007199254740991,
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "following": {
                  "anyOf": [
                    {
                      "maximum": 9007199254740991,
                      "minimum": -9007199254740991,
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "handle": {
                  "type": "string"
                },
                "id": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "location": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "name": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "profileImage": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "tweetCount": {
                  "anyOf": [
                    {
                      "maximum": 9007199254740991,
                      "minimum": -9007199254740991,
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "url": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "verified": {
                  "additionalProperties": false,
                  "properties": {
                    "blue": {
                      "type": "boolean"
                    },
                    "type": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "blue",
                    "type"
                  ],
                  "type": "object"
                }
              },
              "required": [
                "handle",
                "id",
                "name",
                "bio",
                "url",
                "location",
                "profileImage",
                "verified",
                "followers",
                "following",
                "tweetCount",
                "createdAt",
                "accountAgeDays"
              ],
              "type": "object"
            }
          },
          "required": [
            "profile",
            "activity",
            "authenticity"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}