{
  "openapi": "3.1.0",
  "info": {
    "title": "Twitter API — Profile",
    "version": "1.0.0",
    "description": "User profile metadata and account context."
  },
  "servers": [
    {
      "url": "https://api.fetchlayer.dev/twitter"
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "description": "Every error, on every route. Branch on code and retryable rather than on the text; on a 5xx the text is generic. MCP tool errors carry the same fields in structuredContent, and as a JSON text block.",
        "properties": {
          "error": {
            "type": "string",
            "description": "What went wrong, in words. For a 400, what to change."
          },
          "status": {
            "type": "integer",
            "description": "The HTTP status, repeated in the body."
          },
          "code": {
            "type": "string",
            "description": "The kind of error, stable: invalid_input, unauthorized, insufficient_credits, forbidden, not_found, expired, quota_exceeded, cancelled, time_limit, temporarily_unavailable, posts_unavailable, store_unreachable, upstream_error, internal_error, tool_error. A platform may add its own; more may be added. Treat a code you do not recognise by its retryable flag."
          },
          "retryable": {
            "type": "boolean",
            "description": "Whether asking again can succeed."
          },
          "requestId": {
            "type": "string",
            "description": "This request’s id, also sent as the X-Request-Id header. Quote it when reporting a problem."
          },
          "missing": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "With invalid_input when the request's parameters are refused before the request runs: the parameters that were missing. Always present on those errors, empty when nothing was missing."
          }
        },
        "required": [
          "error",
          "code",
          "retryable",
          "requestId"
        ]
      }
    },
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Send your FetchLayer key as Authorization: Bearer ss-your-key."
      }
    }
  },
  "paths": {
    "/user-profile-details": {
      "post": {
        "operationId": "user-profile-details",
        "tags": [
          "Profile"
        ],
        "summary": "Fetch a user profile by handle",
        "description": "Retrieve a Twitter user profile and top-level account metadata by handle. Includes bio, follower/following counts, join date, and verification status. An account that does not exist is a 404 user_not_found (\"No X account with handle @x.\"), and so is a suspended one (the error says it is suspended); a 404 is final, not retryable, and not billed (2026-11-13; before, it was a retryable 503).",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "handle": {
                    "type": "string",
                    "description": "Twitter handle without @."
                  },
                  "timeoutMs": {
                    "type": "integer",
                    "description": "Time limit for the whole request, in milliseconds (1000–120000; values outside are brought into that range). It can only shorten the time a request may take, which is about 90 seconds at most. With maxItems, a call that runs out returns the pages it has, billed for those, with hasMore and nextCursor; a call with nothing to return yet fails with a 503 you can retry. We answer at the latest about 2 seconds before timeoutMs runs out (15% of it, at least 0.75 s, for limits under 13 seconds), so you can set it to your own client’s timeout. Left out, the request takes the time it needs."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "handle"
                ]
              },
              "examples": {
                "default": {
                  "value": {
                    "handle": "NASA"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "scrapedAt": {
                      "type": "string",
                      "description": "ISO 8601 time the result was produced."
                    },
                    "transport": {
                      "type": "string",
                      "description": "The data source: always the platform id, \"twitter\"."
                    },
                    "entityType": {
                      "type": "string",
                      "description": "Always twitter-user-profile-details."
                    },
                    "cached": {
                      "type": "boolean",
                      "description": "Present (true) only when the answer is a recent copy rather than a fresh read; scrapedAt then says when it was read. Only for a public profile, and at most 10 minutes old."
                    },
                    "profile": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "additionalProperties": true,
                      "description": "The account; null when it could not be found.",
                      "properties": {
                        "id": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Numeric account id, as a string. It stays the same when the handle changes."
                        },
                        "name": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Display name."
                        },
                        "handle": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Handle without the @."
                        },
                        "description": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Bio text."
                        },
                        "location": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Location as the account wrote it."
                        },
                        "followersCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Followers."
                        },
                        "followingCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Accounts followed."
                        },
                        "tweetsCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Posts, replies included."
                        },
                        "mediaCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Posts with media."
                        },
                        "verified": {
                          "type": [
                            "boolean",
                            "null"
                          ],
                          "description": "Whether the account carries a verification checkmark (see verification for which kind)."
                        },
                        "avatarUrl": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Profile image URL."
                        },
                        "bannerUrl": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Header image URL, or null."
                        },
                        "createdAt": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "When the account was created, as X writes it: \"Wed Dec 19 20:20:32 +0000 2007\" (UTC)."
                        },
                        "favoritesCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Posts the account has liked."
                        },
                        "listedCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Lists the account is on. Currently always null: X no longer sends it."
                        },
                        "fastFollowersCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Currently always null: X no longer sends it. Use followersCount."
                        },
                        "normalFollowersCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Currently always null: X no longer sends it. Use followersCount."
                        },
                        "creatorSubscriptionsCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Creator subscriptions the account has, or null when X leaves it out."
                        },
                        "pinnedTweetIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Ids of the pinned posts; empty when none."
                        },
                        "website": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "The website link on the profile; null when there is none.",
                          "properties": {
                            "url": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The t.co short link."
                            },
                            "expandedUrl": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The full address it leads to."
                            },
                            "displayUrl": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The shortened form X displays, e.g. nasa.gov."
                            }
                          }
                        },
                        "descriptionUrls": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true,
                            "properties": {
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The t.co short link."
                              },
                              "expandedUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The full address it leads to."
                              },
                              "displayUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The shortened form X displays, e.g. nasa.gov."
                              }
                            }
                          },
                          "description": "Links in the bio, expanded; empty when none."
                        },
                        "avatarUrlLarge": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The profile image at 400x400."
                        },
                        "verifiedType": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The kind of verification, e.g. Business or Government; null for none."
                        },
                        "protected": {
                          "type": [
                            "boolean",
                            "null"
                          ],
                          "description": "True when the account’s posts are visible to its followers only."
                        },
                        "profileLabel": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "The affiliation badge shown next to the name (e.g. an organisation’s); null when there is none.",
                          "properties": {
                            "description": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The badge’s label, e.g. the organisation’s name."
                            },
                            "badgeUrl": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The badge image."
                            },
                            "url": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "Where the badge links to."
                            },
                            "urlType": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "X’s link type, e.g. DeepLink."
                            },
                            "displayType": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "How X shows it, e.g. Badge."
                            },
                            "type": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "X’s label type, e.g. BusinessLabel."
                            }
                          }
                        },
                        "verification": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "Which verification the account has.",
                          "properties": {
                            "blue": {
                              "type": [
                                "boolean",
                                "null"
                              ],
                              "description": "Verified through a subscription (the blue checkmark)."
                            },
                            "verified": {
                              "type": [
                                "boolean",
                                "null"
                              ],
                              "description": "Verified by X as notable (legacy verification)."
                            },
                            "identityVerified": {
                              "type": [
                                "boolean",
                                "null"
                              ],
                              "description": "The account holder’s identity was verified; null when X does not say."
                            },
                            "reason": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "X’s own explanation of the checkmark, e.g. for a government account; null when it gives none."
                            }
                          }
                        }
                      }
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "default": {
                    "value": {
                      "entityType": "twitter-user-profile-details",
                      "profile": {
                        "id": "11348282",
                        "name": "NASA",
                        "handle": "NASA",
                        "description": "Making the seemingly impossible, possible. ✨",
                        "location": "Pale Blue Dot",
                        "followersCount": 92312272,
                        "followingCount": 115,
                        "tweetsCount": 74455,
                        "mediaCount": 28207,
                        "verified": true,
                        "avatarUrl": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_normal.jpg",
                        "bannerUrl": "https://pbs.twimg.com/profile_banners/11348282/1788992290",
                        "createdAt": "Wed Dec 19 20:20:32 +0000 2007",
                        "favoritesCount": 17049,
                        "listedCount": null,
                        "pinnedTweetIds": [],
                        "profileLabel": null,
                        "verification": {
                          "blue": true,
                          "verified": false,
                          "identityVerified": false,
                          "reason": "This account is verified because it is a government or multilateral organization account."
                        }
                      },
                      "scrapedAt": "2026-10-25T19:14:00.000Z",
                      "transport": "twitter"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "invalid_input: the request needs fixing; error names the field.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "unauthorized: the API key is missing or not valid.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "insufficient_credits: no credits, trial or monthly allowance left.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "forbidden: this key or account is not allowed this request.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "quota_exceeded: a request-rate limit was reached.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "temporarily_unavailable, time_limit or (on a store route) store_unreachable: ask again (with time_limit, allow more time). Retryable.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ]
      }
    },
    "/about-profile": {
      "post": {
        "operationId": "about-profile",
        "tags": [
          "Profile"
        ],
        "summary": "Fetch “about this profile” metadata",
        "description": "Retrieve extended profile context for a Twitter account including professional category, and any linked entities. An account that does not exist is a 404 user_not_found (\"No X account with handle @x.\"), and so is a suspended one (the error says it is suspended); a 404 is final, not retryable, and not billed (2026-11-13; before, it was a retryable 503).",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "handle": {
                    "type": "string",
                    "description": "Twitter handle without @."
                  },
                  "timeoutMs": {
                    "type": "integer",
                    "description": "Time limit for the whole request, in milliseconds (1000–120000; values outside are brought into that range). It can only shorten the time a request may take, which is about 90 seconds at most. With maxItems, a call that runs out returns the pages it has, billed for those, with hasMore and nextCursor; a call with nothing to return yet fails with a 503 you can retry. We answer at the latest about 2 seconds before timeoutMs runs out (15% of it, at least 0.75 s, for limits under 13 seconds), so you can set it to your own client’s timeout. Left out, the request takes the time it needs."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "handle"
                ]
              },
              "examples": {
                "default": {
                  "value": {
                    "handle": "NASA"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "scrapedAt": {
                      "type": "string",
                      "description": "ISO 8601 time the result was produced."
                    },
                    "transport": {
                      "type": "string",
                      "description": "The data source: always the platform id, \"twitter\"."
                    },
                    "entityType": {
                      "type": "string",
                      "description": "Always twitter-about-profile."
                    },
                    "profile": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "additionalProperties": true,
                      "description": "The account in full, as user-profile-details returns it.",
                      "properties": {
                        "id": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Numeric account id, as a string. It stays the same when the handle changes."
                        },
                        "name": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Display name."
                        },
                        "handle": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Handle without the @."
                        },
                        "description": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Bio text."
                        },
                        "location": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Location as the account wrote it."
                        },
                        "followersCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Followers."
                        },
                        "followingCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Accounts followed."
                        },
                        "tweetsCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Posts, replies included."
                        },
                        "mediaCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Posts with media."
                        },
                        "verified": {
                          "type": [
                            "boolean",
                            "null"
                          ],
                          "description": "Whether the account carries a verification checkmark (see verification for which kind)."
                        },
                        "avatarUrl": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Profile image URL."
                        },
                        "bannerUrl": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Header image URL, or null."
                        },
                        "createdAt": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "When the account was created, as X writes it: \"Wed Dec 19 20:20:32 +0000 2007\" (UTC)."
                        },
                        "favoritesCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Posts the account has liked."
                        },
                        "listedCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Lists the account is on. Currently always null: X no longer sends it."
                        },
                        "fastFollowersCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Currently always null: X no longer sends it. Use followersCount."
                        },
                        "normalFollowersCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Currently always null: X no longer sends it. Use followersCount."
                        },
                        "creatorSubscriptionsCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Creator subscriptions the account has, or null when X leaves it out."
                        },
                        "pinnedTweetIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Ids of the pinned posts; empty when none."
                        },
                        "website": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "The website link on the profile; null when there is none.",
                          "properties": {
                            "url": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The t.co short link."
                            },
                            "expandedUrl": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The full address it leads to."
                            },
                            "displayUrl": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The shortened form X displays, e.g. nasa.gov."
                            }
                          }
                        },
                        "descriptionUrls": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true,
                            "properties": {
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The t.co short link."
                              },
                              "expandedUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The full address it leads to."
                              },
                              "displayUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The shortened form X displays, e.g. nasa.gov."
                              }
                            }
                          },
                          "description": "Links in the bio, expanded; empty when none."
                        },
                        "avatarUrlLarge": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The profile image at 400x400."
                        },
                        "verifiedType": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The kind of verification, e.g. Business or Government; null for none."
                        },
                        "protected": {
                          "type": [
                            "boolean",
                            "null"
                          ],
                          "description": "True when the account’s posts are visible to its followers only."
                        },
                        "profileLabel": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "The affiliation badge shown next to the name (e.g. an organisation’s); null when there is none.",
                          "properties": {
                            "description": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The badge’s label, e.g. the organisation’s name."
                            },
                            "badgeUrl": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The badge image."
                            },
                            "url": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "Where the badge links to."
                            },
                            "urlType": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "X’s link type, e.g. DeepLink."
                            },
                            "displayType": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "How X shows it, e.g. Badge."
                            },
                            "type": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "X’s label type, e.g. BusinessLabel."
                            }
                          }
                        },
                        "verification": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "Which verification the account has.",
                          "properties": {
                            "blue": {
                              "type": [
                                "boolean",
                                "null"
                              ],
                              "description": "Verified through a subscription (the blue checkmark)."
                            },
                            "verified": {
                              "type": [
                                "boolean",
                                "null"
                              ],
                              "description": "Verified by X as notable (legacy verification)."
                            },
                            "identityVerified": {
                              "type": [
                                "boolean",
                                "null"
                              ],
                              "description": "The account holder’s identity was verified; null when X does not say."
                            },
                            "reason": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "X’s own explanation of the checkmark, e.g. for a government account; null when it gives none."
                            }
                          }
                        }
                      }
                    },
                    "aboutProfile": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "additionalProperties": true,
                      "description": "X’s “About this account” panel; null when X shows none.",
                      "properties": {
                        "accountBasedIn": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The country X says the account is based in."
                        },
                        "locationAccurate": {
                          "type": [
                            "boolean",
                            "null"
                          ],
                          "description": "Whether X considers that location accurate."
                        },
                        "createdCountryAccurate": {
                          "type": [
                            "boolean",
                            "null"
                          ],
                          "description": "Whether X considers the country the account was created in accurate."
                        },
                        "source": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "How the account connected to X, as the panel says (e.g. an app store)."
                        },
                        "affiliateUsername": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The organisation the account is affiliated with, when it has one."
                        },
                        "usernameChanges": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "How often the handle has changed.",
                          "properties": {
                            "count": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "description": "Number of handle changes."
                            },
                            "lastChangedAtMsec": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "When the handle last changed, in milliseconds since the epoch (as a string); null when it never has."
                            }
                          }
                        },
                        "learnMoreUrl": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "X’s page explaining the panel."
                        }
                      }
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "default": {
                    "value": {
                      "entityType": "twitter-about-profile",
                      "profile": {
                        "id": "11348282",
                        "name": "NASA",
                        "handle": "NASA",
                        "followersCount": 92312272,
                        "verified": true
                      },
                      "aboutProfile": {
                        "accountBasedIn": "United States",
                        "locationAccurate": true,
                        "createdCountryAccurate": true,
                        "source": null,
                        "affiliateUsername": null,
                        "usernameChanges": {
                          "count": 0,
                          "lastChangedAtMsec": null
                        },
                        "learnMoreUrl": "https://help.x.com/managing-your-account/about-twitter-verified-accounts"
                      },
                      "scrapedAt": "2026-10-25T19:15:00.000Z",
                      "transport": "twitter"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "invalid_input: the request needs fixing; error names the field.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "unauthorized: the API key is missing or not valid.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "insufficient_credits: no credits, trial or monthly allowance left.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "forbidden: this key or account is not allowed this request.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "quota_exceeded: a request-rate limit was reached.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "temporarily_unavailable, time_limit or (on a store route) store_unreachable: ask again (with time_limit, allow more time). Retryable.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ]
      }
    }
  }
}