{"openapi":"3.1.0","info":{"title":"xfetch Public API","version":"1.0.0","description":"Public customer API for xfetch read workflows."},"servers":[{"url":"https://api.xfetch.io","description":"Production API"}],"security":[{"BearerAuth":[]}],"paths":{"/v1/trends":{"get":{"summary":"GET /v1/trends","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"woeid","in":"query","required":false,"schema":{"type":"string"},"description":"WOEID (Where On Earth ID); defaults to 1 (worldwide)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Envelope"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/search/recent":{"get":{"summary":"GET /v1/search/recent","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":20,"default":20},"description":"Page size for search-backed results."},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1TweetObject"}}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/users/{id}":{"get":{"summary":"GET /v1/users/:id","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1UserObject"}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/users/by-username/{username}":{"get":{"summary":"GET /v1/users/by-username/:username","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"username","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1UserObject"}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/users":{"get":{"summary":"GET /v1/users?ids=...","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"ids","in":"query","required":true,"schema":{"type":"string"},"description":"Comma-separated IDs."}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1UserObject"}}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/users/{id}/tweets":{"get":{"summary":"GET /v1/users/:id/tweets","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1TweetObject"}}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/users/{id}/tweets/replies":{"get":{"summary":"GET /v1/users/:id/tweets/replies","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1TweetObject"}}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/users/{id}/media":{"get":{"summary":"GET /v1/users/:id/media","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1TweetObject"}}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/users/{id}/followers":{"get":{"summary":"GET /v1/users/:id/followers?mode=ids|profiles","tags":["Basic Reads","Enriched Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"mode","in":"query","required":false,"schema":{"type":"string","enum":["ids","profiles"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":5000,"default":200},"description":"Supported only when mode=ids."}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/V1IdObject"}},{"type":"array","items":{"$ref":"#/components/schemas/V1UserObject"}}]}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/users/{id}/verified-followers":{"get":{"summary":"GET /v1/users/:id/verified-followers","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1UserObject"}}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/users/{id}/following":{"get":{"summary":"GET /v1/users/:id/following?mode=ids|profiles","tags":["Basic Reads","Enriched Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"mode","in":"query","required":false,"schema":{"type":"string","enum":["ids","profiles"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":5000,"default":200},"description":"Supported only when mode=ids."}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/V1IdObject"}},{"type":"array","items":{"$ref":"#/components/schemas/V1UserObject"}}]}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/tweets/{id}":{"get":{"summary":"GET /v1/tweets/:id","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1TweetObject"}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/tweets":{"get":{"summary":"GET /v1/tweets?ids=...","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"ids","in":"query","required":true,"schema":{"type":"string"},"description":"Comma-separated IDs."}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1TweetObject"}}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/tweets/{id}/quotes":{"get":{"summary":"GET /v1/tweets/:id/quotes","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1TweetObject"}}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/tweets/{id}/retweeters":{"get":{"summary":"GET /v1/tweets/:id/retweeters","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1UserObject"}}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/tweets/{id}/conversation":{"get":{"summary":"GET /v1/tweets/:id/conversation","tags":["Workflow APIs"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1TweetObject"}}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/lists/{id}/tweets":{"get":{"summary":"GET /v1/lists/:id/tweets","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1TweetObject"}}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/lists/{id}/members":{"get":{"summary":"GET /v1/lists/:id/members","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1UserObject"}}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/lists/{id}/subscribers":{"get":{"summary":"GET /v1/lists/:id/subscribers","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1UserObject"}}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/communities/{id}":{"get":{"summary":"GET /v1/communities/:id","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Envelope"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/communities/search":{"get":{"summary":"GET /v1/communities/search","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Envelope"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/search/recent/enriched":{"get":{"summary":"GET /v1/search/recent/enriched","tags":["Enriched Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":20,"default":20},"description":"Page size for search-backed results."},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"type":"object","properties":{"tweets":{"type":"array","items":{"$ref":"#/components/schemas/V1TweetObject"}},"authors":{"type":"array","items":{"$ref":"#/components/schemas/V1UserObject"}}}}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/profiles/{id}":{"get":{"summary":"GET /v1/profiles/:id","tags":["Workflow APIs"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"type":"object","properties":{"user":{"$ref":"#/components/schemas/V1UserObject"},"recent_tweets":{"type":"array","items":{"$ref":"#/components/schemas/V1TweetObject"}}}}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/profiles/by-username/{username}":{"get":{"summary":"GET /v1/profiles/by-username/:username","tags":["Workflow APIs"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"username","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"type":"object","properties":{"user":{"$ref":"#/components/schemas/V1UserObject"},"recent_tweets":{"type":"array","items":{"$ref":"#/components/schemas/V1TweetObject"}}}}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/tweets/{id}/context":{"get":{"summary":"GET /v1/tweets/:id/context","tags":["Workflow APIs"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1TweetContextData"}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/communities/{id}/tweets":{"get":{"summary":"GET /v1/communities/:id/tweets","tags":["Enriched Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["relevance","recency","likes"]}},{"name":"time_filter","in":"query","required":false,"schema":{"type":"string","enum":["day","week","month","year","all"]},"description":"Only accepted when sort=likes."}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1TweetObject"}}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/communities/{id}/members":{"get":{"summary":"GET /v1/communities/:id/members","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1UserObject"}}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/communities/{id}/moderators":{"get":{"summary":"GET /v1/communities/:id/moderators","tags":["Basic Reads"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful xfetch workflow response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V1Envelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1UserObject"}}}}]}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/2/tweets/search/recent":{"get":{"summary":"GET /2/tweets/search/recent","tags":["/2 Compatibility"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"}},{"name":"sort_order","in":"query","required":false,"schema":{"type":"string","enum":["recency","relevancy"]}},{"name":"max_results","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":20,"default":20}},{"name":"pagination_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"tweet.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated tweet fields."},{"name":"user.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated user fields."},{"name":"expansions","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["author_id"]}},"description":"Comma-separated expansions. Supported value: author_id. Returns related author objects in includes.users."}],"responses":{"200":{"description":"Successful official-compatible response.","headers":{"x-request-id":{"description":"Request identifier for support and tracing.","schema":{"type":"string","example":"req_123"}},"x-credits-charged":{"description":"Credits charged for this successful request.","schema":{"type":"integer","example":1}},"x-credits-remaining":{"description":"Credits remaining after this successful request.","schema":{"type":"integer","example":99}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfficialEnvelope"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/2/users/by/username/{username}":{"get":{"summary":"GET /2/users/by/username/:username","tags":["/2 Compatibility"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"username","in":"path","required":true,"schema":{"type":"string"}},{"name":"user.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated user fields."}],"responses":{"200":{"description":"Successful official-compatible response.","headers":{"x-request-id":{"description":"Request identifier for support and tracing.","schema":{"type":"string","example":"req_123"}},"x-credits-charged":{"description":"Credits charged for this successful request.","schema":{"type":"integer","example":1}},"x-credits-remaining":{"description":"Credits remaining after this successful request.","schema":{"type":"integer","example":99}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfficialEnvelope"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/2/users/{id}/tweets":{"get":{"summary":"GET /2/users/:id/tweets","tags":["/2 Compatibility"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"max_results","in":"query","required":false,"schema":{"type":"integer","minimum":5,"maximum":100,"default":20}},{"name":"pagination_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"tweet.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated tweet fields."},{"name":"user.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated user fields."},{"name":"expansions","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["author_id"]}},"description":"Comma-separated expansions. Supported value: author_id. Returns related author objects in includes.users."}],"responses":{"200":{"description":"Successful official-compatible response.","headers":{"x-request-id":{"description":"Request identifier for support and tracing.","schema":{"type":"string","example":"req_123"}},"x-credits-charged":{"description":"Credits charged for this successful request.","schema":{"type":"integer","example":1}},"x-credits-remaining":{"description":"Credits remaining after this successful request.","schema":{"type":"integer","example":99}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfficialEnvelope"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/2/users/{id}/followers":{"get":{"summary":"GET /2/users/:id/followers","tags":["/2 Compatibility"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"max_results","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}},{"name":"pagination_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"user.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated user fields."}],"responses":{"200":{"description":"Successful official-compatible response.","headers":{"x-request-id":{"description":"Request identifier for support and tracing.","schema":{"type":"string","example":"req_123"}},"x-credits-charged":{"description":"Credits charged for this successful request.","schema":{"type":"integer","example":1}},"x-credits-remaining":{"description":"Credits remaining after this successful request.","schema":{"type":"integer","example":99}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfficialEnvelope"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/2/users/{id}/following":{"get":{"summary":"GET /2/users/:id/following","tags":["/2 Compatibility"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"max_results","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}},{"name":"pagination_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"user.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated user fields."}],"responses":{"200":{"description":"Successful official-compatible response.","headers":{"x-request-id":{"description":"Request identifier for support and tracing.","schema":{"type":"string","example":"req_123"}},"x-credits-charged":{"description":"Credits charged for this successful request.","schema":{"type":"integer","example":1}},"x-credits-remaining":{"description":"Credits remaining after this successful request.","schema":{"type":"integer","example":99}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfficialEnvelope"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/2/users/{id}":{"get":{"summary":"GET /2/users/:id","tags":["/2 Compatibility"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"user.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated user fields."}],"responses":{"200":{"description":"Successful official-compatible response.","headers":{"x-request-id":{"description":"Request identifier for support and tracing.","schema":{"type":"string","example":"req_123"}},"x-credits-charged":{"description":"Credits charged for this successful request.","schema":{"type":"integer","example":1}},"x-credits-remaining":{"description":"Credits remaining after this successful request.","schema":{"type":"integer","example":99}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfficialEnvelope"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/2/users":{"get":{"summary":"GET /2/users?ids=...","tags":["/2 Compatibility"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"ids","in":"query","required":true,"schema":{"type":"string"},"description":"Comma-separated IDs."},{"name":"user.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated user fields."}],"responses":{"200":{"description":"Successful official-compatible response.","headers":{"x-request-id":{"description":"Request identifier for support and tracing.","schema":{"type":"string","example":"req_123"}},"x-credits-charged":{"description":"Credits charged for this successful request.","schema":{"type":"integer","example":1}},"x-credits-remaining":{"description":"Credits remaining after this successful request.","schema":{"type":"integer","example":99}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfficialEnvelope"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/2/tweets/{id}/retweeted_by":{"get":{"summary":"GET /2/tweets/:id/retweeted_by","tags":["/2 Compatibility"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"max_results","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":100}},{"name":"pagination_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"user.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated user fields."}],"responses":{"200":{"description":"Successful official-compatible response.","headers":{"x-request-id":{"description":"Request identifier for support and tracing.","schema":{"type":"string","example":"req_123"}},"x-credits-charged":{"description":"Credits charged for this successful request.","schema":{"type":"integer","example":1}},"x-credits-remaining":{"description":"Credits remaining after this successful request.","schema":{"type":"integer","example":99}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfficialEnvelope"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/2/tweets/{id}/quote_tweets":{"get":{"summary":"GET /2/tweets/:id/quote_tweets","tags":["/2 Compatibility"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"max_results","in":"query","required":false,"schema":{"type":"integer","minimum":10,"maximum":100,"default":10}},{"name":"pagination_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"tweet.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated tweet fields."},{"name":"user.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated user fields."},{"name":"expansions","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["author_id"]}},"description":"Comma-separated expansions. Supported value: author_id. Returns related author objects in includes.users."}],"responses":{"200":{"description":"Successful official-compatible response.","headers":{"x-request-id":{"description":"Request identifier for support and tracing.","schema":{"type":"string","example":"req_123"}},"x-credits-charged":{"description":"Credits charged for this successful request.","schema":{"type":"integer","example":1}},"x-credits-remaining":{"description":"Credits remaining after this successful request.","schema":{"type":"integer","example":99}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfficialEnvelope"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/2/tweets/{id}":{"get":{"summary":"GET /2/tweets/:id","tags":["/2 Compatibility"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"tweet.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated tweet fields."},{"name":"user.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated user fields."},{"name":"expansions","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["author_id"]}},"description":"Comma-separated expansions. Supported value: author_id. Returns related author objects in includes.users."}],"responses":{"200":{"description":"Successful official-compatible response.","headers":{"x-request-id":{"description":"Request identifier for support and tracing.","schema":{"type":"string","example":"req_123"}},"x-credits-charged":{"description":"Credits charged for this successful request.","schema":{"type":"integer","example":1}},"x-credits-remaining":{"description":"Credits remaining after this successful request.","schema":{"type":"integer","example":99}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfficialEnvelope"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/2/tweets":{"get":{"summary":"GET /2/tweets?ids=...","tags":["/2 Compatibility"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"ids","in":"query","required":true,"schema":{"type":"string"},"description":"Comma-separated IDs."},{"name":"tweet.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated tweet fields."},{"name":"user.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated user fields."},{"name":"expansions","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["author_id"]}},"description":"Comma-separated expansions. Supported value: author_id. Returns related author objects in includes.users."}],"responses":{"200":{"description":"Successful official-compatible response.","headers":{"x-request-id":{"description":"Request identifier for support and tracing.","schema":{"type":"string","example":"req_123"}},"x-credits-charged":{"description":"Credits charged for this successful request.","schema":{"type":"integer","example":1}},"x-credits-remaining":{"description":"Credits remaining after this successful request.","schema":{"type":"integer","example":99}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfficialEnvelope"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/2/lists/{id}/tweets":{"get":{"summary":"GET /2/lists/:id/tweets","tags":["/2 Compatibility"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"max_results","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":100}},{"name":"pagination_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"tweet.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated tweet fields."},{"name":"user.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated user fields."},{"name":"expansions","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["author_id"]}},"description":"Comma-separated expansions. Supported value: author_id. Returns related author objects in includes.users."}],"responses":{"200":{"description":"Successful official-compatible response.","headers":{"x-request-id":{"description":"Request identifier for support and tracing.","schema":{"type":"string","example":"req_123"}},"x-credits-charged":{"description":"Credits charged for this successful request.","schema":{"type":"integer","example":1}},"x-credits-remaining":{"description":"Credits remaining after this successful request.","schema":{"type":"integer","example":99}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfficialEnvelope"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/2/lists/{id}/members":{"get":{"summary":"GET /2/lists/:id/members","tags":["/2 Compatibility"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"max_results","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":100}},{"name":"pagination_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"user.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated user fields."}],"responses":{"200":{"description":"Successful official-compatible response.","headers":{"x-request-id":{"description":"Request identifier for support and tracing.","schema":{"type":"string","example":"req_123"}},"x-credits-charged":{"description":"Credits charged for this successful request.","schema":{"type":"integer","example":1}},"x-credits-remaining":{"description":"Credits remaining after this successful request.","schema":{"type":"integer","example":99}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfficialEnvelope"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/2/lists/{id}/followers":{"get":{"summary":"GET /2/lists/:id/followers","tags":["/2 Compatibility"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"max_results","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":100}},{"name":"pagination_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"next_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"user.fields","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated user fields."}],"responses":{"200":{"description":"Successful official-compatible response.","headers":{"x-request-id":{"description":"Request identifier for support and tracing.","schema":{"type":"string","example":"req_123"}},"x-credits-charged":{"description":"Credits charged for this successful request.","schema":{"type":"integer","example":1}},"x-credits-remaining":{"description":"Credits remaining after this successful request.","schema":{"type":"integer","example":99}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfficialEnvelope"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Resource or endpoint not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"V1Envelope":{"type":"object","required":["data","meta"],"properties":{"data":{},"meta":{"type":"object","required":["request_id","credits"],"properties":{"request_id":{"type":"string"},"credits":{"type":"object","required":["charged","remaining"],"properties":{"charged":{"type":"integer","example":1},"remaining":{"type":"integer","example":99}}},"pagination":{"type":"object","properties":{"next_token":{"type":"string"}}}}}}},"OfficialEnvelope":{"type":"object","properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/OfficialUserObject"},{"$ref":"#/components/schemas/OfficialTweetObject"},{"type":"array","items":{"$ref":"#/components/schemas/OfficialUserObject"}},{"type":"array","items":{"$ref":"#/components/schemas/OfficialTweetObject"}}]},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"$ref":"#/components/schemas/OfficialUserObject"}}}},"errors":{"type":"array","items":{"$ref":"#/components/schemas/OfficialProblem"}},"meta":{"type":"object","properties":{"result_count":{"type":"integer"},"next_token":{"type":"string"}}}}},"OfficialProblem":{"type":"object","required":["type","title"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"detail":{"type":"string"},"resource_id":{"type":"string"},"parameter":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user"]},"value":{"type":"string"}}},"OfficialUserObject":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"username":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"description":{"type":"string"},"location":{"type":"string"},"profile_image_url":{"type":"string"},"protected":{"type":"boolean"},"verified":{"type":"boolean"},"public_metrics":{"type":"object","properties":{"followers_count":{"type":"integer"},"following_count":{"type":"integer"},"tweet_count":{"type":"integer"}}}}},"OfficialTweetObject":{"type":"object","required":["id","text","edit_history_tweet_ids"],"properties":{"id":{"type":"string"},"text":{"type":"string"},"edit_history_tweet_ids":{"type":"array","items":{"type":"string"}},"author_id":{"type":"string"},"conversation_id":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"in_reply_to_user_id":{"type":"string"},"lang":{"type":"string"},"possibly_sensitive":{"type":"boolean"},"public_metrics":{"type":"object","properties":{"retweet_count":{"type":"integer"},"reply_count":{"type":"integer"},"like_count":{"type":"integer"},"quote_count":{"type":"integer"},"bookmark_count":{"type":"integer"}}},"entities":{"type":"object","properties":{"hashtags":{"type":"array","items":{"type":"string"}},"urls":{"type":"array","items":{"type":"string"}},"mentions":{"type":"array","items":{"type":"string"}}}},"referenced_tweets":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["quoted"]},"id":{"type":"string"}}}}}},"ErrorEnvelope":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}}}}},"V1UserObject":{"type":"object","required":["id","username","name","description","created_at","verified","protected","profile_image_url","follower_count","following_count","tweet_count"],"properties":{"id":{"type":"string"},"username":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"location":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"verified":{"type":"boolean"},"protected":{"type":"boolean"},"profile_image_url":{"type":"string"},"follower_count":{"type":"integer"},"following_count":{"type":"integer"},"tweet_count":{"type":"integer"},"media_count":{"type":"integer"}}},"V1IdObject":{"type":"object","required":["id"],"properties":{"id":{"type":"string"}}},"V1TweetObject":{"type":"object","required":["id","text","author_id","created_at","lang","like_count","retweet_count","reply_count","quote_count","bookmark_count","is_quote_status","entities"],"properties":{"id":{"type":"string"},"text":{"type":"string"},"author_id":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"lang":{"type":"string"},"like_count":{"type":"integer"},"retweet_count":{"type":"integer"},"reply_count":{"type":"integer"},"quote_count":{"type":"integer"},"bookmark_count":{"type":"integer"},"is_quote_status":{"type":"boolean"},"quoted_tweet_id":{"type":"string"},"entities":{"type":"object","required":["hashtags","urls","mentions"],"properties":{"hashtags":{"type":"array","items":{"type":"string"}},"urls":{"type":"array","items":{"type":"string"}},"mentions":{"type":"array","items":{"type":"string"}}}},"media":{"type":"array","items":{"type":"object","required":["type","url"],"properties":{"type":{"type":"string"},"url":{"type":"string"}}}}}},"V1TweetContextData":{"type":"object","required":["tweet","author","quotes","retweeters"],"properties":{"tweet":{"$ref":"#/components/schemas/V1TweetObject"},"author":{"$ref":"#/components/schemas/V1UserObject"},"quotes":{"type":"array","items":{"$ref":"#/components/schemas/V1TweetObject"}},"retweeters":{"type":"array","items":{"$ref":"#/components/schemas/V1UserObject"}}}}}}}