> ## Documentation Index > Fetch the complete documentation index at: https://docs.trytikt.com/llms.txt > Use this file to discover all available pages before exploring further. # List posts > The posts of your tracked profiles, with their harvest state, their performance against the profile's usual posts and their yield in leads. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/posts openapi: 3.1.0 info: title: TIKT API version: '2026-10-01' description: >- Read your leads with their verdict criterion by criterion, and answer TIKT: file, discard, exclude, pause, track. Server to server only: never call it from a browser. servers: - url: https://api.trytikt.com security: - apiKey: [] tags: - name: workspace - name: leads - name: lists - name: posts - name: tracked-profiles - name: icp - name: analytics - name: events - name: webhook-endpoints - name: workflows - name: tools paths: /v1/posts: get: tags: - posts summary: List posts description: >- The posts of your tracked profiles, with their harvest state, their performance against the profile's usual posts and their yield in leads. operationId: listPosts parameters: - name: kol_id in: query required: false schema: type: string pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ description: Only the posts of this tracked profile. - name: tracking_status in: query required: false schema: type: string enum: - hot - warm - closed description: >- Only posts TIKT reads often (`hot`), less often (`warm`), or no longer (`closed`). - name: source in: query required: false schema: type: string enum: - auto - onboarding - manual description: >- Only posts found by the agent (`auto`), at setup (`onboarding`) or added by hand (`manual`). - name: posted_after in: query required: false schema: type: string maxLength: 40 description: Only posts published from this date on (ISO 8601). - name: paused in: query required: false schema: type: string enum: - 'true' - 'false' description: >- `true`: only posts whose harvest you paused; `false`: only the others. - name: sort in: query required: false schema: default: posted_at type: string enum: - posted_at - reactions - comments - leads description: >- `posted_at` (the default, newest first), `reactions`, `comments` or `leads`. - name: limit in: query required: false schema: type: string pattern: ^\d{1,3}$ description: Items per page, from 1 to 100. 50 by default. - name: cursor in: query required: false schema: type: string minLength: 1 maxLength: 600 description: >- The `next_cursor` of the previous page. Leave it out for the first page. responses: '200': description: Success. content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/PostWithHarvest' page: type: object properties: next_cursor: anyOf: - type: string - type: 'null' has_more: type: boolean required: - next_cursor - has_more additionalProperties: false required: - data - page additionalProperties: false '400': $ref: '#/components/responses/E400' '401': $ref: '#/components/responses/E401' '404': $ref: '#/components/responses/E404' '429': $ref: '#/components/responses/E429' '500': $ref: '#/components/responses/E500' '503': $ref: '#/components/responses/E503' security: - apiKey: [] components: schemas: PostWithHarvest: type: object properties: id: type: string pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ linkedin_post_id: type: string urn: type: string url: type: string author: type: object properties: type: type: string name: anyOf: - type: string - type: 'null' public_id: anyOf: - type: string - type: 'null' linkedin_url: anyOf: - type: string - type: 'null' avatar_url: anyOf: - type: string - type: 'null' required: - type - name - public_id - linkedin_url - avatar_url additionalProperties: false text: anyOf: - type: string - type: 'null' hashtags: type: array items: type: string media_type: anyOf: - type: string - type: 'null' media: type: object properties: images: type: array items: type: string videos: type: array items: type: string required: - images - videos additionalProperties: false external_links: type: array items: type: string is_repost: type: boolean posted_at: anyOf: - type: string pattern: ^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\dZ$ - type: 'null' counters: type: object properties: reactions: anyOf: - type: integer - type: 'null' comments: anyOf: - type: integer - type: 'null' checked_at: anyOf: - type: string pattern: ^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\dZ$ - type: 'null' required: - reactions - comments - checked_at additionalProperties: false tracking_status: type: string source: type: string kol: $ref: '#/components/schemas/TrackedProfileSummary' console_url: type: string harvest: type: object properties: state: type: string paused: type: boolean excluded_reason: anyOf: - type: string - type: 'null' required: - state - paused - excluded_reason additionalProperties: false performance_vs_usual: anyOf: - type: number - type: 'null' yield: type: object properties: people_captured: type: integer leads_at_threshold: type: integer avg_score_at_threshold: anyOf: - type: number - type: 'null' required: - people_captured - leads_at_threshold - avg_score_at_threshold additionalProperties: false required: - id - linkedin_post_id - urn - url - author - text - hashtags - media_type - media - external_links - is_repost - posted_at - counters - tracking_status - source - kol - console_url - harvest - performance_vs_usual - yield additionalProperties: false TrackedProfileSummary: type: object properties: id: type: string pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ name: anyOf: - type: string - type: 'null' relationship: anyOf: - type: string - type: 'null' linkedin_url: anyOf: - type: string - type: 'null' required: - id - name - relationship - linkedin_url additionalProperties: false Error: type: object properties: error: type: object properties: code: type: string enum: - parametre_inconnu - parametre_invalide - corps_invalide - curseur_invalide - cle_absente - cle_invalide - cle_revoquee - cle_de_lecture - introuvable - methode_non_permise - limite_atteinte - corps_trop_gros - refus - trop_de_requetes - erreur_interne - indisponible message: type: string status: type: integer request_id: anyOf: - type: string - type: 'null' details: type: object additionalProperties: true required: - code - message - status - request_id additionalProperties: false required: - error additionalProperties: false responses: E400: description: Error 400. content: application/json: schema: $ref: '#/components/schemas/Error' E401: description: Error 401. content: application/json: schema: $ref: '#/components/schemas/Error' E404: description: Error 404. content: application/json: schema: $ref: '#/components/schemas/Error' E429: description: Error 429. content: application/json: schema: $ref: '#/components/schemas/Error' E500: description: Error 500. content: application/json: schema: $ref: '#/components/schemas/Error' E503: description: Error 503. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: apiKey: type: http scheme: bearer description: >- Your API key, created in Settings › API: `Authorization: Bearer tikt_live_…`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.