> ## Documentation Index > Fetch the complete documentation index at: https://docs.tryhuntr.com/llms.txt > Use this file to discover all available pages before exploring further. # X Thread > Return thread context for one X post. ## OpenAPI ````yaml /openapi.json post /x-thread openapi: 3.0.3 info: title: Huntr — The GTM Intelligence API description: >- Give AI agents company, people, contact, and web intelligence through one API. Search accounts, build targeted lists, enrich leads, find contacts, and uncover buying signals. **Authentication:** Authenticated endpoints require an `x-api-key` header with your Huntr API key. Get a key by signing up via `POST /keys/create`. Public endpoints (pricing, sign-up, health) work without a key. **Rate limit:** 5 requests/second per API key on authenticated endpoints. version: 2.0.0 servers: - url: https://api.tryhuntr.com security: [] tags: - name: Contact APIs description: >- Search people and enrich work email, phone, and reverse-email contact fields. - name: Company APIs description: >- Search companies and retrieve company-level attributes such as detected technology stack and active job postings. - name: Research APIs description: >- Research one company, person, team, or focused business question and return a sales-ready answer. Lite, standard, and deep tiers. - name: LinkedIn APIs description: >- LinkedIn URL discovery, company and profile pages, posts, reactions, and comments. - name: X APIs description: X profiles, posts, search results, and thread context. - name: Web APIs description: >- Find, scrape, and analyze pages on a domain, plus tech stack, domain contacts, and job postings. - name: Account description: >- Sign up, verify email, recover keys, check balance, view usage, add credits, and read the public pricing matrix. - name: System description: Health check. paths: /x-thread: post: tags: - X APIs summary: X Thread description: Return thread context for one X post. requestBody: required: true content: application/json: schema: type: object required: - post properties: post: type: string description: X post ID or public x.com/twitter.com post URL. pagination: type: object description: >- Huntr-controlled page size. Only pagination.token is accepted; pagination.size is not supported. properties: token: type: string description: Opaque token from the previous response. additionalProperties: false example: post: https://x.com/openai/status/1900000000000000000 responses: '200': description: Thread page returned. content: application/json: schema: type: object properties: success: type: boolean request_id: type: string result: type: object properties: tweets: type: array items: type: object properties: id: type: string url: type: string text: type: string createdAt: type: string author: type: object additionalProperties: true additionalProperties: true required: - tweets - pagination additionalProperties: true pagination: type: object required: - size - token - has_more properties: size: type: number description: >- Number of X posts returned in result.tweets for this response page. token: type: string description: >- Opaque token for the next page. Null means there is no next page. nullable: true has_more: type: boolean description: >- Whether another page is available. When false, pagination.token is null. additionalProperties: false total: type: number description: Number of X posts returned in this response page. price: type: number description: Amount charged for this request. credits_remaining: type: number description: Credit balance after this request. required: - success - request_id - result - price - credits_remaining - pagination - total example: success: true request_id: req_1746123456_xth1x2y result: tweets: - id: '1900000000000000000' url: https://x.com/OpenAI/status/1900000000000000000 text: Introducing new AI research and product updates. createdAt: '2026-07-20T16:00:00.000Z' author: userName: OpenAI name: OpenAI - id: '1900000000000000001' url: https://x.com/OpenAI/status/1900000000000000001 text: More details in the thread. createdAt: '2026-07-20T16:01:00.000Z' author: userName: OpenAI name: OpenAI pagination: size: 2 token: opaque-next-page-token has_more: true total: 2 price: 0.00046 credits_remaining: 4.99954 '400': description: Invalid post or pagination token. content: application/json: schema: $ref: '#/components/schemas/Error' '402': description: Insufficient credits for the returned page. content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Thread lookup failed. content: application/json: schema: $ref: '#/components/schemas/Error' security: - ApiKeyAuth: [] x-codeSamples: - lang: Shell label: cURL source: |- curl --request POST \ --url https://api.tryhuntr.com/x-thread \ --header 'x-api-key: ' \ --header 'Content-Type: application/json' \ --data '{ "post": "https://x.com/openai/status/1900000000000000000" }' x-code-samples: - lang: Shell label: cURL source: |- curl --request POST \ --url https://api.tryhuntr.com/x-thread \ --header 'x-api-key: ' \ --header 'Content-Type: application/json' \ --data '{ "post": "https://x.com/openai/status/1900000000000000000" }' components: schemas: Error: type: object properties: error: type: string description: Human-readable error message. required: - error securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your Huntr API key. Get one at tryhuntr.com. Pass as x-api-key header on all authenticated requests. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.