Skip to main content
POST
/
twitter
/
grok
/
extract
/
submit
Queue Grok extraction (webhook + polling)
curl --request POST \
  --url 'https://api.xshot.fun/twitter/grok/extract/submit?api_key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tweet_ids": [
    "<string>"
  ],
  "webhook_url": "<string>",
  "webhook_secret": "<string>",
  "skip_null": true
}
'
{
  "job_id": "<string>",
  "count": 123,
  "mode": "<string>",
  "webhook": true,
  "poll": "<string>"
}

Authorizations

​
api_key
string
query
required

Body

application/json
​
tweet_ids
string[]
required

Up to 500 tweet IDs.

​
mode
enum<string>

fast (1 question, no resolution), token (2 questions, resolves on-chain), suggest (1 question — resolves the token if the post is about one, else proposes tickers).

Available options:
fast,
token,
suggest
​
webhook_url
string

Optional http(s) URL; each result is POSTed here as it completes.

​
webhook_secret
string

Optional. If set, each webhook carries x-signature = "sha256=" + hex HMAC-SHA256(rawBody, webhook_secret).

​
skip_null
boolean

Skip tweets with no token, no extracted ticker and no suggestions (snipe-only feeds).

Response

200 - application/json

Job accepted

​
job_id
string
​
count
integer
​
mode
string
​
webhook
boolean
​
poll
string