botsmith | Apiosk Gateway

Base URL

https://gateway.apiosk.com/cbz-x402-botsmith-dev

Technical Specs

Auth MethodNone (x402 payment proof only)

Response FormatJSON

Endpoints2

Endpoints

Method	Path	Description	Cost
GET	/x/search	X Tweet Search ($0.02/call): Search X (Twitter) posts with full advanced-search syntax (from:, since:, until:, exact phrases, boolean operators). Returns up to 20 posts per call as clean JSON with metrics and entities, plus a cursor for the next page. No X account or API key needed.	$0.02 default	View details
GET	/x/tweet	X Tweet Lookup ($0.015/call): Fetch one X (Twitter) post by numeric id: full text, author, ISO timestamp, like/retweet/reply/view counts, hashtags, expanded links and mentions as clean JSON. No X account or API key needed.	$0.02 default	View details

Endpoint documentation

GET/x/search

$0.02 default

Description

X Tweet Search ($0.02/call): Search X (Twitter) posts with full advanced-search syntax (from:, since:, until:, exact phrases, boolean operators). Returns up to 20 posts per call as clean JSON with metrics and entities, plus a cursor for the next page. No X account or API key needed.

Pricing

$0.02 default

Parameters

{
  "additionalProperties": false,
  "properties": {
    "cursor": {
      "description": "Pagination cursor from a previous call",
      "pattern": "^[A-Za-z0-9+/=_-]{1,400}$",
      "type": "string"
    },
    "query": {
      "description": "Search query, e.g. \"x402 from:coinbase since:2026-07-01\"",
      "maxLength": 400,
      "minLength": 1,
      "type": "string"
    },
    "type": {
      "default": "Latest",
      "description": "Sort by recency or engagement",
      "enum": [
        "Latest",
        "Top"
      ],
      "type": "string"
    }
  },
  "required": [
    "query",
    "type"
  ],
  "type": "object"
}

Example response

{
  "hasNextPage": true,
  "nextCursor": "DAACCgACGgAAAAAAAAA",
  "tweets": [
    {
      "author": {
        "handle": "example",
        "id": "44196397",
        "name": "Example Dev"
      },
      "createdAt": "2026-07-01T07:00:30.000Z",
      "hashtags": [
        "x402"
      ],
      "id": "1846987139428634858",
      "lang": "en",
      "links": [
        "https://x402.org"
      ],
      "mentions": [
        "coinbase"
      ],
      "metrics": {
        "likes": 1200,
        "quotes": 12,
        "replies": 85,
        "retweets": 340,
        "views": 250000
      },
      "text": "Shipping the new agent payments stack today. HTTP 402 is finally real.",
      "url": "https://x.com/example/status/1846987139428634858"
    }
  ]
}

GET/x/tweet

$0.02 default

Description

X Tweet Lookup ($0.015/call): Fetch one X (Twitter) post by numeric id: full text, author, ISO timestamp, like/retweet/reply/view counts, hashtags, expanded links and mentions as clean JSON. No X account or API key needed.

Pricing

$0.02 default

Parameters

{
  "additionalProperties": false,
  "properties": {
    "id": {
      "description": "Numeric tweet/post id",
      "pattern": "^[0-9]{1,25}$",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

Example response

{
  "author": {
    "handle": "example",
    "id": "44196397",
    "name": "Example Dev"
  },
  "createdAt": "2026-07-01T07:00:30.000Z",
  "hashtags": [
    "x402"
  ],
  "id": "1846987139428634858",
  "lang": "en",
  "links": [
    "https://x402.org"
  ],
  "mentions": [
    "coinbase"
  ],
  "metrics": {
    "likes": 1200,
    "quotes": 12,
    "replies": 85,
    "retweets": 340,
    "views": 250000
  },
  "text": "Shipping the new agent payments stack today. HTTP 402 is finally real.",
  "url": "https://x.com/example/status/1846987139428634858"
}