curl --request POST \
  --url https://developer.thehog.ai/api/v1/platform/scrapers/x/search-posts \
  --header 'Content-Type: application/json' \
  --header 'X-Access-Key: <api-key>' \
  --header 'X-Secret-Key: <api-key>' \
  --data '
{
  "query": "typescript nestjs",
  "maxTweets": 100.5,
  "options": {
    "dateFrom": "<string>",
    "dateTo": "<string>",
    "lang": "<string>",
    "geocode": "<string>"
  }
}
'

const options = {
  method: 'POST',
  headers: {
    'X-Access-Key': '<api-key>',
    'X-Secret-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: 'typescript nestjs',
    maxTweets: 100.5,
    options: {
      dateFrom: '<string>',
      dateTo: '<string>',
      lang: '<string>',
      geocode: '<string>'
    }
  })
};

fetch('https://developer.thehog.ai/api/v1/platform/scrapers/x/search-posts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://developer.thehog.ai/api/v1/platform/scrapers/x/search-posts"

payload = {
    "query": "typescript nestjs",
    "maxTweets": 100.5,
    "options": {
        "dateFrom": "<string>",
        "dateTo": "<string>",
        "lang": "<string>",
        "geocode": "<string>"
    }
}
headers = {
    "X-Access-Key": "<api-key>",
    "X-Secret-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": [
    {
      "id": "<string>",
      "text": "<string>",
      "is_retweet": true,
      "created_at": "<string>",
      "source": "<string>",
      "lang": "<string>",
      "conversation_id": "<string>",
      "view_count": 123,
      "bookmark_count": 123,
      "like_count": 123,
      "retweet_count": 123,
      "reply_count": 123,
      "quote_count": 123,
      "url": "<string>",
      "is_quote": true,
      "is_reply": true,
      "author_x_user_id": "<string>",
      "author_username": "<string>",
      "author_display_name": "<string>",
      "retweet_tweet_id": "<string>",
      "quote_tweet_id": "<string>"
    }
  ],
  "meta": {
    "requestId": "<string>"
  }
}

{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "Validation failed",
  "path": "/api/v1/search",
  "timestamp": "2026-05-21T09:08:10.000Z",
  "requestId": "506af9b3-01a9-43be-9eb4-8458fe3e4f5b",
  "errors": [
    {
      "property": "body.query",
      "message": "query must be a string",
      "constraints": {
        "isString": "query must be a string"
      }
    }
  ]
}

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Authentication is required.",
  "path": "/api/v1/search",
  "timestamp": "2026-05-21T09:08:10.000Z",
  "requestId": "506af9b3-01a9-43be-9eb4-8458fe3e4f5b"
}

{
  "statusCode": 402,
  "error": "Payment Required",
  "message": "Insufficient credits.",
  "path": "/api/v1/search",
  "timestamp": "2026-05-21T09:08:10.000Z",
  "requestId": "506af9b3-01a9-43be-9eb4-8458fe3e4f5b"
}

{
  "statusCode": 500,
  "error": "Internal Server Error",
  "message": "An unexpected error occurred.",
  "path": "/api/v1/search",
  "timestamp": "2026-05-21T09:08:10.000Z",
  "requestId": "506af9b3-01a9-43be-9eb4-8458fe3e4f5b"
}

{
  "statusCode": 502,
  "error": "Bad Gateway",
  "message": "An unexpected error occurred.",
  "path": "/api/v1/search",
  "timestamp": "2026-05-21T09:08:10.000Z",
  "requestId": "506af9b3-01a9-43be-9eb4-8458fe3e4f5b"
}