{
  "product": "Social Fetch",
  "generatedFrom": [
    "OpenAPI",
    "public-api-endpoint-metadata",
    "docs-operation-urls.json",
    "sdk-method-docs.ts"
  ],
  "docs": {
    "llmsTxtUrl": "https://www.socialfetch.dev/llms.txt",
    "llmsJsonUrl": "https://www.socialfetch.dev/llms.json",
    "docsHomeMarkdownUrl": "https://www.socialfetch.dev/docs.mdx",
    "quickstartMarkdownUrl": "https://www.socialfetch.dev/docs/quickstart.mdx",
    "sdkMarkdownUrl": "https://www.socialfetch.dev/docs/sdk.mdx",
    "sdkReferenceMarkdownUrl": "https://www.socialfetch.dev/docs/sdk-reference.mdx",
    "chooseEndpointMarkdownUrl": "https://www.socialfetch.dev/docs/choose-endpoint.mdx",
    "capabilityMatrixMarkdownUrl": "https://www.socialfetch.dev/docs/capability-matrix.mdx",
    "apiIndexMarkdownUrl": "https://www.socialfetch.dev/docs/api.mdx",
    "errorsMarkdownUrl": "https://www.socialfetch.dev/docs/errors.mdx",
    "creditsMarkdownUrl": "https://www.socialfetch.dev/docs/credits.mdx",
    "openApiUrl": "https://www.socialfetch.dev/openapi.json"
  },
  "counts": {
    "documentedOperations": 41,
    "sdkWrappedOperations": 41,
    "httpOnlyOperations": 0
  },
  "operations": [
    {
      "method": "GET",
      "path": "/v1/tiktok/profiles/{handle}",
      "summary": "Get TikTok profile",
      "tag": "TikTok",
      "operationId": "tiktok.profile.get",
      "requiresApiKey": true,
      "docsPathname": "/docs/api/v1/tiktok/profiles/handle/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/profiles/handle/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/profiles/handle/get.mdx",
      "sdkMethod": {
        "resource": "tiktok",
        "methodName": "getProfile",
        "signature": "client.tiktok.getProfile({ handle })",
        "clientCall": "client.tiktok.getProfile({ handle })"
      },
      "parameterNames": [
        "handle"
      ],
      "acceptedIdentifiers": [
        {
          "name": "handle",
          "location": "path",
          "required": true,
          "type": "string",
          "description": "TikTok handle to look up, with or without a leading @."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "private",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/tiktok/profiles/{handle}/videos",
      "summary": "List TikTok profile videos",
      "tag": "TikTok",
      "operationId": "tiktok.profile.videos.list",
      "requiresApiKey": true,
      "docsPathname": "/docs/api/v1/tiktok/profiles/handle/videos/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/profiles/handle/videos/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/profiles/handle/videos/get.mdx",
      "sdkMethod": {
        "resource": "tiktok",
        "methodName": "getProfileVideos",
        "signature": "client.tiktok.getProfileVideos({ handle, sortBy?, cursor?, userId?, region?, trim? })",
        "clientCall": "client.tiktok.getProfileVideos({ handle, cursor? })"
      },
      "parameterNames": [
        "handle",
        "sortBy",
        "cursor",
        "userId",
        "region",
        "trim"
      ],
      "acceptedIdentifiers": [
        {
          "name": "handle",
          "location": "path",
          "required": true,
          "type": "string",
          "description": "TikTok handle whose videos should be listed."
        },
        {
          "name": "userId",
          "location": "query",
          "required": false,
          "type": "string",
          "description": "Optional TikTok user id to speed up the request."
        }
      ],
      "pagination": {
        "style": "cursor",
        "parameter": "cursor",
        "nextCursorPath": "data.page.nextCursor",
        "hasMorePath": "data.page.hasMore"
      },
      "sortByValues": [
        "latest",
        "popular"
      ],
      "orderingHint": "Supported sort options: latest, popular.",
      "supportsTrim": true,
      "supportsMediaDownload": false,
      "agentHints": {
        "emptyResults": "An empty `data.videos` array can mean no videos in the selected sort window, a private profile, or other cases—there is no `lookupStatus` field on this route.",
        "disambiguation": "Call `GET /v1/tiktok/profiles/{handle}` when you need explicit `lookupStatus` including `private` or `not_found` before interpreting an empty video list."
      }
    },
    {
      "method": "GET",
      "path": "/v1/tiktok/videos",
      "summary": "Get TikTok video",
      "tag": "TikTok",
      "operationId": "tiktok.video.get",
      "requiresApiKey": true,
      "creditsNote": "1 credit base; +10 when `downloadMedia=true` (up to 11 credits on success). See `meta.creditsCharged`. Normalization failures are charged 1 credit.",
      "docsPathname": "/docs/api/v1/tiktok/videos/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/videos/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/videos/get.mdx",
      "sdkMethod": {
        "resource": "tiktok",
        "methodName": "getVideo",
        "signature": "client.tiktok.getVideo({ url, region?, trim?, downloadMedia? })",
        "clientCall": "client.tiktok.getVideo({ url })"
      },
      "parameterNames": [
        "url",
        "region",
        "trim",
        "downloadMedia",
        "getTranscript"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Link to the video or photo post."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": true,
      "supportsMediaDownload": true
    },
    {
      "method": "GET",
      "path": "/v1/tiktok/videos/comments",
      "summary": "List TikTok video comments",
      "tag": "TikTok",
      "operationId": "tiktok.video.comments.list",
      "requiresApiKey": true,
      "creditsNote": "1 credit base (up to 1 credits on success). See `meta.creditsCharged`.",
      "docsPathname": "/docs/api/v1/tiktok/videos/comments/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/videos/comments/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/videos/comments/get.mdx",
      "sdkMethod": {
        "resource": "tiktok",
        "methodName": "getVideoComments",
        "signature": "client.tiktok.getVideoComments({ url, cursor?, trim? })",
        "clientCall": "client.tiktok.getVideoComments({ url })"
      },
      "parameterNames": [
        "url",
        "cursor",
        "trim"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Link to the TikTok video whose comments should be listed."
        }
      ],
      "pagination": {
        "style": "cursor",
        "parameter": "cursor",
        "nextCursorPath": "data.page.nextCursor",
        "hasMorePath": "data.page.hasMore"
      },
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": true,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/tiktok/videos/transcript",
      "summary": "Get TikTok video transcript",
      "tag": "TikTok",
      "operationId": "tiktok.video.transcript.get",
      "requiresApiKey": true,
      "creditsNote": "1 credit base; +10 when `useAiFallback=true` (up to 11 credits on success). See `meta.creditsCharged`. Normalization failures are charged 1 credit.",
      "docsPathname": "/docs/api/v1/tiktok/videos/transcript/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/videos/transcript/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/videos/transcript/get.mdx",
      "sdkMethod": {
        "resource": "tiktok",
        "methodName": "getVideoTranscript",
        "signature": "client.tiktok.getVideoTranscript({ url, language?, useAiFallback? })",
        "clientCall": "client.tiktok.getVideoTranscript({ url })"
      },
      "parameterNames": [
        "url",
        "language",
        "useAiFallback"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Link to the TikTok video whose transcript should be returned."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/tiktok/profiles/{handle}/live",
      "summary": "Get TikTok live stream",
      "tag": "TikTok",
      "operationId": "tiktok.profile.live.check",
      "requiresApiKey": true,
      "docsPathname": "/docs/api/v1/tiktok/profiles/handle/live/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/profiles/handle/live/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/profiles/handle/live/get.mdx",
      "sdkMethod": {
        "resource": "tiktok",
        "methodName": "getProfileLive",
        "signature": "client.tiktok.getProfileLive({ handle })",
        "clientCall": "client.tiktok.getProfileLive({ handle })"
      },
      "parameterNames": [
        "handle"
      ],
      "acceptedIdentifiers": [
        {
          "name": "handle",
          "location": "path",
          "required": true,
          "type": "string",
          "description": "TikTok handle to look up, with or without a leading @."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/tiktok/shop/products/search",
      "summary": "Search TikTok Shop products",
      "tag": "TikTok",
      "operationId": "tiktok.shop.products.search",
      "requiresApiKey": true,
      "creditsNote": "1 credit base (up to 1 credits on success). See `meta.creditsCharged`.",
      "docsPathname": "/docs/api/v1/tiktok/shop/products/search/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/shop/products/search/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/shop/products/search/get.mdx",
      "sdkMethod": {
        "resource": "tiktok",
        "methodName": "searchShopProducts",
        "signature": "client.tiktok.searchShopProducts({ query, page?, region? })",
        "clientCall": "client.tiktok.searchShopProducts({ query })"
      },
      "parameterNames": [
        "query",
        "page",
        "region"
      ],
      "acceptedIdentifiers": [],
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/tiktok/shop/products",
      "summary": "List TikTok Shop store products",
      "tag": "TikTok",
      "operationId": "tiktok.shop.products.list",
      "requiresApiKey": true,
      "creditsNote": "1 credit base (up to 1 credits on success). See `meta.creditsCharged`.",
      "docsPathname": "/docs/api/v1/tiktok/shop/products/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/shop/products/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/shop/products/get.mdx",
      "sdkMethod": {
        "resource": "tiktok",
        "methodName": "listShopProducts",
        "signature": "client.tiktok.listShopProducts({ url, cursor?, region? })",
        "clientCall": "client.tiktok.listShopProducts({ url })"
      },
      "parameterNames": [
        "url",
        "cursor",
        "region"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Public TikTok Shop store URL whose products should be listed."
        }
      ],
      "pagination": {
        "style": "cursor",
        "parameter": "cursor",
        "nextCursorPath": "data.page.nextCursor",
        "hasMorePath": "data.page.hasMore"
      },
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/tiktok/products",
      "summary": "Get TikTok Shop product",
      "tag": "TikTok",
      "operationId": "tiktok.product.get",
      "requiresApiKey": true,
      "creditsNote": "1 credit base (up to 1 credits on success). See `meta.creditsCharged`.",
      "docsPathname": "/docs/api/v1/tiktok/products/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/products/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/products/get.mdx",
      "sdkMethod": {
        "resource": "tiktok",
        "methodName": "getProduct",
        "signature": "client.tiktok.getProduct({ url, region? })",
        "clientCall": "client.tiktok.getProduct({ url })"
      },
      "parameterNames": [
        "url",
        "region"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Public TikTok Shop product detail page URL for the product to retrieve."
        }
      ],
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/tiktok/products/reviews",
      "summary": "List TikTok Shop product reviews",
      "tag": "TikTok",
      "operationId": "tiktok.product.reviews.list",
      "requiresApiKey": true,
      "creditsNote": "1 credit base (up to 1 credits on success). See `meta.creditsCharged`.",
      "docsPathname": "/docs/api/v1/tiktok/products/reviews/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/products/reviews/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/products/reviews/get.mdx",
      "sdkMethod": {
        "resource": "tiktok",
        "methodName": "getProductReviews",
        "signature": "client.tiktok.getProductReviews({ url?, productId?, region?, page? })",
        "clientCall": "client.tiktok.getProductReviews({ url: 'https://www.tiktok.com/shop/pdp/...' })"
      },
      "parameterNames": [
        "url",
        "productId",
        "region",
        "page"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": false,
          "type": "string",
          "description": "Public TikTok Shop product detail page URL for the product whose reviews should be listed."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/tiktok/profiles/{handle}/showcase-products",
      "summary": "List TikTok profile showcase products",
      "tag": "TikTok",
      "operationId": "tiktok.profile.showcaseProducts.list",
      "requiresApiKey": true,
      "docsPathname": "/docs/api/v1/tiktok/profiles/handle/showcase-products/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/profiles/handle/showcase-products/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/tiktok/profiles/handle/showcase-products/get.mdx",
      "sdkMethod": {
        "resource": "tiktok",
        "methodName": "getProfileShowcaseProducts",
        "signature": "client.tiktok.getProfileShowcaseProducts({ handle, cursor?, region? })",
        "clientCall": "client.tiktok.getProfileShowcaseProducts({ handle, cursor? })"
      },
      "parameterNames": [
        "handle",
        "cursor",
        "region"
      ],
      "acceptedIdentifiers": [
        {
          "name": "handle",
          "location": "path",
          "required": true,
          "type": "string",
          "description": "TikTok handle whose profile showcase products should be listed."
        }
      ],
      "pagination": {
        "style": "cursor",
        "parameter": "cursor",
        "nextCursorPath": "data.page.nextCursor",
        "hasMorePath": "data.page.hasMore"
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false,
      "agentHints": {
        "emptyResults": "An empty `data.products` array can mean no showcased products, a private profile, or other cases—there is no `lookupStatus` field on this route.",
        "disambiguation": "Call `GET /v1/tiktok/profiles/{handle}` when you need explicit profile lookup status before interpreting an empty showcase list."
      }
    },
    {
      "method": "GET",
      "path": "/v1/facebook/profiles",
      "summary": "Get Facebook profile",
      "tag": "Facebook",
      "operationId": "facebook.profile.get",
      "requiresApiKey": true,
      "docsPathname": "/docs/api/v1/facebook/profiles/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/facebook/profiles/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/facebook/profiles/get.mdx",
      "sdkMethod": {
        "resource": "facebook",
        "methodName": "getProfile",
        "signature": "client.facebook.getProfile({ url, includeBusinessHours? })",
        "clientCall": "client.facebook.getProfile({ url, includeBusinessHours? })"
      },
      "parameterNames": [
        "url",
        "includeBusinessHours"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Facebook public profile or page URL to look up."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "private",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/facebook/profiles/posts",
      "summary": "List Facebook profile posts",
      "tag": "Facebook",
      "operationId": "facebook.profile.posts.list",
      "requiresApiKey": true,
      "docsPathname": "/docs/api/v1/facebook/profiles/posts/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/facebook/profiles/posts/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/facebook/profiles/posts/get.mdx",
      "sdkMethod": {
        "resource": "facebook",
        "methodName": "getProfilePosts",
        "signature": "client.facebook.getProfilePosts({ url?, pageId?, cursor? })",
        "clientCall": "client.facebook.getProfilePosts({ url?, pageId?, cursor? })"
      },
      "parameterNames": [
        "url",
        "pageId",
        "cursor"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": false,
          "type": "string",
          "description": "Full public Facebook profile or page URL."
        }
      ],
      "pagination": {
        "style": "cursor",
        "parameter": "cursor",
        "nextCursorPath": "data.page.nextCursor",
        "hasMorePath": "data.page.hasMore"
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false,
      "agentHints": {
        "emptyResults": "An empty `data.posts` page with `hasMore: false` can represent no public posts, restricted visibility, or an unresolvable URL or id—there is no `lookupStatus` field on this route.",
        "disambiguation": "Call `GET /v1/facebook/profiles` first when you need `found` / `private` / `not_found` before interpreting an empty posts page."
      }
    },
    {
      "method": "GET",
      "path": "/v1/facebook/profiles/reels",
      "summary": "List Facebook profile reels",
      "tag": "Facebook",
      "operationId": "facebook.profile.reels.list",
      "requiresApiKey": true,
      "docsPathname": "/docs/api/v1/facebook/profiles/reels/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/facebook/profiles/reels/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/facebook/profiles/reels/get.mdx",
      "sdkMethod": {
        "resource": "facebook",
        "methodName": "getProfileReels",
        "signature": "client.facebook.getProfileReels({ url, cursor? })",
        "clientCall": "client.facebook.getProfileReels({ url })"
      },
      "parameterNames": [
        "url",
        "cursor"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Public Facebook profile or page URL whose reels should be listed."
        }
      ],
      "pagination": {
        "style": "cursor",
        "parameter": "cursor",
        "nextCursorPath": "data.page.nextCursor",
        "hasMorePath": "data.page.hasMore"
      },
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/facebook/profiles/photos",
      "summary": "List Facebook profile photos",
      "tag": "Facebook",
      "operationId": "facebook.profile.photos.list",
      "requiresApiKey": true,
      "docsPathname": "/docs/api/v1/facebook/profiles/photos/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/facebook/profiles/photos/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/facebook/profiles/photos/get.mdx",
      "sdkMethod": {
        "resource": "facebook",
        "methodName": "getProfilePhotos",
        "signature": "client.facebook.getProfilePhotos({ url, cursor? })",
        "clientCall": "client.facebook.getProfilePhotos({ url })"
      },
      "parameterNames": [
        "url",
        "cursor"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Public Facebook profile or page URL whose photos should be listed."
        }
      ],
      "pagination": {
        "style": "cursor",
        "parameter": "cursor",
        "nextCursorPath": "data.page.nextCursor",
        "hasMorePath": "data.page.hasMore"
      },
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/facebook/posts",
      "summary": "Get Facebook post or reel",
      "tag": "Facebook",
      "operationId": "facebook.post.get",
      "requiresApiKey": true,
      "creditsNote": "1 credit base (up to 1 credits on success). See `meta.creditsCharged`.",
      "docsPathname": "/docs/api/v1/facebook/posts/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/facebook/posts/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/facebook/posts/get.mdx",
      "sdkMethod": {
        "resource": "facebook",
        "methodName": "getPost",
        "signature": "client.facebook.getPost({ url, includeComments?, includeTranscript? })",
        "clientCall": "client.facebook.getPost({ url })"
      },
      "parameterNames": [
        "url",
        "includeComments",
        "includeTranscript"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Public permalink to the Facebook post or reel."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/facebook/posts/comments",
      "summary": "List Facebook post or reel comments",
      "tag": "Facebook",
      "operationId": "facebook.post.comments.list",
      "requiresApiKey": true,
      "creditsNote": "1 credit base (up to 1 credits on success). See `meta.creditsCharged`.",
      "docsPathname": "/docs/api/v1/facebook/posts/comments/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/facebook/posts/comments/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/facebook/posts/comments/get.mdx",
      "sdkMethod": {
        "resource": "facebook",
        "methodName": "getPostComments",
        "signature": "client.facebook.getPostComments({ url?, cursor?, feedbackId? })",
        "clientCall": "client.facebook.getPostComments({ url })"
      },
      "parameterNames": [
        "url",
        "cursor",
        "feedbackId"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": false,
          "type": "string",
          "description": "Link to the Facebook post or reel whose comments should be listed."
        }
      ],
      "pagination": {
        "style": "cursor",
        "parameter": "cursor",
        "nextCursorPath": "data.page.nextCursor",
        "hasMorePath": "data.page.hasMore"
      },
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/facebook/posts/transcript",
      "summary": "Get Facebook post transcript",
      "tag": "Facebook",
      "operationId": "facebook.post.transcript.get",
      "requiresApiKey": true,
      "creditsNote": "1 credit base (up to 1 credits on success). See `meta.creditsCharged`.",
      "docsPathname": "/docs/api/v1/facebook/posts/transcript/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/facebook/posts/transcript/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/facebook/posts/transcript/get.mdx",
      "sdkMethod": {
        "resource": "facebook",
        "methodName": "getPostTranscript",
        "signature": "client.facebook.getPostTranscript({ url })",
        "clientCall": "client.facebook.getPostTranscript({ url })"
      },
      "parameterNames": [
        "url"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Link to the Facebook post or reel whose transcript should be returned."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found",
          "lookup_failed"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/facebook/groups/posts",
      "summary": "List Facebook group posts",
      "tag": "Facebook",
      "operationId": "facebook.group.posts.list",
      "requiresApiKey": true,
      "creditsNote": "1 credit base (up to 1 credits on success). See `meta.creditsCharged`.",
      "docsPathname": "/docs/api/v1/facebook/groups/posts/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/facebook/groups/posts/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/facebook/groups/posts/get.mdx",
      "sdkMethod": {
        "resource": "facebook",
        "methodName": "listGroupPosts",
        "signature": "client.facebook.listGroupPosts({ url, sortBy?, cursor? })",
        "clientCall": "client.facebook.listGroupPosts({ url, sortBy?, cursor? })"
      },
      "parameterNames": [
        "url",
        "sortBy",
        "cursor"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Public Facebook group URL whose posts should be listed."
        }
      ],
      "pagination": {
        "style": "cursor",
        "parameter": "cursor",
        "nextCursorPath": "data.page.nextCursor",
        "hasMorePath": "data.page.hasMore"
      },
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [
        "top",
        "recentActivity",
        "chronological",
        "chronologicalListings"
      ],
      "orderingHint": "Supported sort options: top, recentActivity, chronological, chronologicalListings.",
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/instagram/profiles/{handle}",
      "summary": "Get Instagram profile",
      "tag": "Instagram",
      "operationId": "instagram.profile.get",
      "requiresApiKey": true,
      "docsPathname": "/docs/api/v1/instagram/profiles/handle/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/instagram/profiles/handle/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/instagram/profiles/handle/get.mdx",
      "sdkMethod": {
        "resource": "instagram",
        "methodName": "getProfile",
        "signature": "client.instagram.getProfile({ handle })",
        "clientCall": "client.instagram.getProfile({ handle })"
      },
      "parameterNames": [
        "handle"
      ],
      "acceptedIdentifiers": [
        {
          "name": "handle",
          "location": "path",
          "required": true,
          "type": "string",
          "description": "Instagram handle to look up, with or without a leading @."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "private",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/instagram/profiles/{handle}/posts",
      "summary": "List Instagram profile posts",
      "tag": "Instagram",
      "operationId": "instagram.profile.posts.list",
      "requiresApiKey": true,
      "docsPathname": "/docs/api/v1/instagram/profiles/handle/posts/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/instagram/profiles/handle/posts/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/instagram/profiles/handle/posts/get.mdx",
      "sdkMethod": {
        "resource": "instagram",
        "methodName": "getProfilePosts",
        "signature": "client.instagram.getProfilePosts({ handle, cursor? })",
        "clientCall": "client.instagram.getProfilePosts({ handle, cursor? })"
      },
      "parameterNames": [
        "handle",
        "cursor"
      ],
      "acceptedIdentifiers": [
        {
          "name": "handle",
          "location": "path",
          "required": true,
          "type": "string",
          "description": "Instagram handle whose posts should be listed."
        }
      ],
      "pagination": {
        "style": "cursor",
        "parameter": "cursor",
        "nextCursorPath": "data.page.nextCursor",
        "hasMorePath": "data.page.hasMore"
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false,
      "agentHints": {
        "emptyResults": "An empty `data.posts` page with `hasMore: false` can represent a private account, a missing handle, no public posts, or similar—there is no `lookupStatus` field on this route.",
        "disambiguation": "Call `GET /v1/instagram/profiles/{handle}` first when you need `found` / `private` / `not_found` before interpreting an empty posts page."
      }
    },
    {
      "method": "GET",
      "path": "/v1/instagram/posts",
      "summary": "Get Instagram post or reel",
      "tag": "Instagram",
      "operationId": "instagram.post.get",
      "requiresApiKey": true,
      "creditsNote": "1 credit base; +10 when `downloadMedia=true` (up to 11 credits on success). See `meta.creditsCharged`. Normalization failures are charged 1 credit.",
      "docsPathname": "/docs/api/v1/instagram/posts/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/instagram/posts/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/instagram/posts/get.mdx",
      "sdkMethod": {
        "resource": "instagram",
        "methodName": "getPost",
        "signature": "client.instagram.getPost({ url, region?, trim?, downloadMedia? })",
        "clientCall": "client.instagram.getPost({ url })"
      },
      "parameterNames": [
        "url",
        "region",
        "trim",
        "downloadMedia"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Link to the post or reel."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": true,
      "supportsMediaDownload": true
    },
    {
      "method": "GET",
      "path": "/v1/instagram/posts/comments",
      "summary": "List Instagram post or reel comments",
      "tag": "Instagram",
      "operationId": "instagram.post.comments.list",
      "requiresApiKey": true,
      "creditsNote": "1 credit base (up to 1 credits on success). See `meta.creditsCharged`.",
      "docsPathname": "/docs/api/v1/instagram/posts/comments/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/instagram/posts/comments/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/instagram/posts/comments/get.mdx",
      "sdkMethod": {
        "resource": "instagram",
        "methodName": "getPostComments",
        "signature": "client.instagram.getPostComments({ url, cursor? })",
        "clientCall": "client.instagram.getPostComments({ url })"
      },
      "parameterNames": [
        "url",
        "cursor"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Link to the Instagram post or reel whose comments should be listed."
        }
      ],
      "pagination": {
        "style": "cursor",
        "parameter": "cursor",
        "nextCursorPath": "data.page.nextCursor",
        "hasMorePath": "data.page.hasMore"
      },
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/linkedin/profiles",
      "summary": "Get LinkedIn profile",
      "tag": "LinkedIn",
      "operationId": "linkedin.profile.get",
      "requiresApiKey": true,
      "docsPathname": "/docs/api/v1/linkedin/profiles/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/linkedin/profiles/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/linkedin/profiles/get.mdx",
      "sdkMethod": {
        "resource": "linkedin",
        "methodName": "getProfile",
        "signature": "client.linkedin.getProfile({ url })",
        "clientCall": "client.linkedin.getProfile({ url })"
      },
      "parameterNames": [
        "url"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "LinkedIn public profile URL for this lookup."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/linkedin/companies",
      "summary": "Get LinkedIn company page",
      "tag": "LinkedIn",
      "operationId": "linkedin.company.get",
      "requiresApiKey": true,
      "creditsNote": "1 credit base (up to 1 credits on success). See `meta.creditsCharged`.",
      "docsPathname": "/docs/api/v1/linkedin/companies/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/linkedin/companies/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/linkedin/companies/get.mdx",
      "sdkMethod": {
        "resource": "linkedin",
        "methodName": "getCompany",
        "signature": "client.linkedin.getCompany({ url })",
        "clientCall": "client.linkedin.getCompany({ url })"
      },
      "parameterNames": [
        "url"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "LinkedIn company page URL for this lookup."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/linkedin/companies/posts",
      "summary": "List LinkedIn company posts",
      "tag": "LinkedIn",
      "operationId": "linkedin.company.posts.list",
      "requiresApiKey": true,
      "docsPathname": "/docs/api/v1/linkedin/companies/posts/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/linkedin/companies/posts/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/linkedin/companies/posts/get.mdx",
      "sdkMethod": {
        "resource": "linkedin",
        "methodName": "listCompanyPosts",
        "signature": "client.linkedin.listCompanyPosts({ url, page? })",
        "clientCall": "client.linkedin.listCompanyPosts({ url })"
      },
      "parameterNames": [
        "url",
        "page"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Public LinkedIn company page URL for the organization whose posts should be listed."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/linkedin/posts",
      "summary": "Get LinkedIn post or article",
      "tag": "LinkedIn",
      "operationId": "linkedin.post.get",
      "requiresApiKey": true,
      "creditsNote": "1 credit base (up to 1 credits on success). See `meta.creditsCharged`.",
      "docsPathname": "/docs/api/v1/linkedin/posts/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/linkedin/posts/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/linkedin/posts/get.mdx",
      "sdkMethod": {
        "resource": "linkedin",
        "methodName": "getPost",
        "signature": "client.linkedin.getPost({ url })",
        "clientCall": "client.linkedin.getPost({ url })"
      },
      "parameterNames": [
        "url"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Public permalink to the post or article."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/youtube/channel",
      "summary": "Get YouTube channel",
      "tag": "YouTube",
      "operationId": "youtube.channel.get",
      "requiresApiKey": true,
      "docsPathname": "/docs/api/v1/youtube/channel/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/youtube/channel/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/youtube/channel/get.mdx",
      "sdkMethod": {
        "resource": "youtube",
        "methodName": "getChannel",
        "signature": "client.youtube.getChannel({ channelId?, handle?, url? })",
        "clientCall": "client.youtube.getChannel({ handle })"
      },
      "parameterNames": [
        "channelId",
        "handle",
        "url"
      ],
      "acceptedIdentifiers": [
        {
          "name": "handle",
          "location": "query",
          "required": false,
          "type": "string",
          "description": "Optional YouTube channel handle for the request."
        },
        {
          "name": "url",
          "location": "query",
          "required": false,
          "type": "string",
          "description": "Optional YouTube channel URL for the request."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/youtube/channels/videos",
      "summary": "List YouTube channel videos",
      "tag": "YouTube",
      "operationId": "youtube.channel.videos.list",
      "requiresApiKey": true,
      "docsPathname": "/docs/api/v1/youtube/channels/videos/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/youtube/channels/videos/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/youtube/channels/videos/get.mdx",
      "sdkMethod": {
        "resource": "youtube",
        "methodName": "getChannelVideos",
        "signature": "client.youtube.getChannelVideos({ channelId?, handle?, sortBy?, cursor?, includeExtras? })",
        "clientCall": "client.youtube.getChannelVideos({ handle })"
      },
      "parameterNames": [
        "channelId",
        "handle",
        "sortBy",
        "cursor",
        "includeExtras"
      ],
      "acceptedIdentifiers": [
        {
          "name": "handle",
          "location": "query",
          "required": false,
          "type": "string",
          "description": "Optional YouTube channel handle for the request."
        }
      ],
      "pagination": {
        "style": "cursor",
        "parameter": "cursor",
        "nextCursorPath": "data.page.nextCursor",
        "hasMorePath": "data.page.hasMore"
      },
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [
        "latest",
        "popular"
      ],
      "orderingHint": "Supported sort options: latest, popular.",
      "supportsTrim": false,
      "supportsMediaDownload": false,
      "agentHints": {
        "emptyResults": "An empty `data.videos` array can still mean `data.lookupStatus: \"found\"` when the channel resolves but the returned page has no videos.",
        "disambiguation": "Use `data.lookupStatus` to distinguish a resolved empty result from `not_found`."
      }
    },
    {
      "method": "GET",
      "path": "/v1/youtube/channels/shorts",
      "summary": "List YouTube channel shorts",
      "tag": "YouTube",
      "operationId": "youtube.channel.shorts.list",
      "requiresApiKey": true,
      "docsPathname": "/docs/api/v1/youtube/channels/shorts/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/youtube/channels/shorts/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/youtube/channels/shorts/get.mdx",
      "sdkMethod": {
        "resource": "youtube",
        "methodName": "getChannelShorts",
        "signature": "client.youtube.getChannelShorts({ channelId?, handle?, sortBy?, cursor? })",
        "clientCall": "client.youtube.getChannelShorts({ handle })"
      },
      "parameterNames": [
        "channelId",
        "handle",
        "sortBy",
        "cursor"
      ],
      "acceptedIdentifiers": [
        {
          "name": "handle",
          "location": "query",
          "required": false,
          "type": "string",
          "description": "Optional YouTube channel handle for the request."
        }
      ],
      "pagination": {
        "style": "cursor",
        "parameter": "cursor",
        "nextCursorPath": "data.page.nextCursor",
        "hasMorePath": "data.page.hasMore"
      },
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [
        "latest",
        "popular"
      ],
      "orderingHint": "Supported sort options: latest, popular.",
      "supportsTrim": false,
      "supportsMediaDownload": false,
      "agentHints": {
        "emptyResults": "An empty `data.shorts` array can still mean `data.lookupStatus: \"found\"` when the channel resolves but the returned page has no Shorts.",
        "disambiguation": "Use `data.lookupStatus` to distinguish a resolved empty result from `not_found`."
      }
    },
    {
      "method": "GET",
      "path": "/v1/youtube/videos",
      "summary": "Get YouTube video",
      "tag": "YouTube",
      "operationId": "youtube.video.get",
      "requiresApiKey": true,
      "creditsNote": "1 credit base (up to 1 credits on success). See `meta.creditsCharged`.",
      "docsPathname": "/docs/api/v1/youtube/videos/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/youtube/videos/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/youtube/videos/get.mdx",
      "sdkMethod": {
        "resource": "youtube",
        "methodName": "getVideo",
        "signature": "client.youtube.getVideo({ url, language? })",
        "clientCall": "client.youtube.getVideo({ url })"
      },
      "parameterNames": [
        "url",
        "language"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Link to the YouTube video. Shorts URLs are also supported."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/youtube/videos/transcript",
      "summary": "Get YouTube video transcript",
      "tag": "YouTube",
      "operationId": "youtube.video.transcript.get",
      "requiresApiKey": true,
      "creditsNote": "1 credit base (up to 1 credits on success). See `meta.creditsCharged`.",
      "docsPathname": "/docs/api/v1/youtube/videos/transcript/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/youtube/videos/transcript/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/youtube/videos/transcript/get.mdx",
      "sdkMethod": {
        "resource": "youtube",
        "methodName": "getVideoTranscript",
        "signature": "client.youtube.getVideoTranscript({ url, language? })",
        "clientCall": "client.youtube.getVideoTranscript({ url })"
      },
      "parameterNames": [
        "url",
        "language"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Link to the YouTube video whose transcript should be returned."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found",
          "lookup_failed"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/twitter/profiles/{handle}",
      "summary": "Get Twitter profile",
      "tag": "Twitter",
      "operationId": "twitter.profile.get",
      "requiresApiKey": true,
      "docsPathname": "/docs/api/v1/twitter/profiles/handle/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/twitter/profiles/handle/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/twitter/profiles/handle/get.mdx",
      "sdkMethod": {
        "resource": "twitter",
        "methodName": "getProfile",
        "signature": "client.twitter.getProfile({ handle })",
        "clientCall": "client.twitter.getProfile({ handle })"
      },
      "parameterNames": [
        "handle"
      ],
      "acceptedIdentifiers": [
        {
          "name": "handle",
          "location": "path",
          "required": true,
          "type": "string",
          "description": "X handle to look up, with or without a leading @."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "private",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/twitter/profiles/{handle}/tweets",
      "summary": "List Twitter profile tweets",
      "tag": "Twitter",
      "operationId": "twitter.profile.tweets.list",
      "requiresApiKey": true,
      "docsPathname": "/docs/api/v1/twitter/profiles/handle/tweets/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/twitter/profiles/handle/tweets/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/twitter/profiles/handle/tweets/get.mdx",
      "sdkMethod": {
        "resource": "twitter",
        "methodName": "getProfileTweets",
        "signature": "client.twitter.getProfileTweets({ handle, trim? })",
        "clientCall": "client.twitter.getProfileTweets({ handle, trim? })"
      },
      "parameterNames": [
        "handle",
        "trim"
      ],
      "acceptedIdentifiers": [
        {
          "name": "handle",
          "location": "path",
          "required": true,
          "type": "string",
          "description": "X handle to look up, with or without a leading @."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "orderingHint": "Default list behavior returns popular results.",
      "supportsTrim": true,
      "supportsMediaDownload": false,
      "agentHints": {
        "emptyResults": "An empty `data.tweets` array can occur with `lookupStatus: \"found\"` (no popular public tweets in this window) or `lookupStatus: \"not_found\"` (handle did not resolve).",
        "disambiguation": "Call `GET /v1/twitter/profiles/{handle}` when you must distinguish `private` from `not_found` before interpreting an empty tweet list."
      }
    },
    {
      "method": "GET",
      "path": "/v1/twitter/search",
      "summary": "Search Twitter posts",
      "tag": "Twitter",
      "operationId": "twitter.search.list",
      "requiresApiKey": true,
      "creditsNote": "2 credit base (up to 2 credits on success). See `meta.creditsCharged`.",
      "docsPathname": "/docs/api/v1/twitter/search/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/twitter/search/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/twitter/search/get.mdx",
      "sdkMethod": {
        "resource": "twitter",
        "methodName": "search",
        "signature": "client.twitter.search({ query, section?, minRetweets?, minLikes?, minReplies?, limit?, startDate?, endDate?, language?, cursor? })",
        "clientCall": "client.twitter.search({ query })"
      },
      "parameterNames": [
        "query",
        "section",
        "minRetweets",
        "minLikes",
        "minReplies",
        "limit",
        "startDate",
        "endDate",
        "language",
        "cursor"
      ],
      "acceptedIdentifiers": [],
      "pagination": {
        "style": "cursor",
        "parameter": "cursor",
        "nextCursorPath": "data.page.nextCursor",
        "hasMorePath": "data.page.hasMore"
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/twitter/tweets",
      "summary": "Get Twitter tweet",
      "tag": "Twitter",
      "operationId": "twitter.tweet.get",
      "requiresApiKey": true,
      "creditsNote": "1 credit base (up to 1 credits on success). See `meta.creditsCharged`.",
      "docsPathname": "/docs/api/v1/twitter/tweets/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/twitter/tweets/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/twitter/tweets/get.mdx",
      "sdkMethod": {
        "resource": "twitter",
        "methodName": "getTweet",
        "signature": "client.twitter.getTweet({ url, trim? })",
        "clientCall": "client.twitter.getTweet({ url })"
      },
      "parameterNames": [
        "url",
        "trim"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Tweet permalink or identifier."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": true,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/twitter/communities",
      "summary": "Get Twitter community",
      "tag": "Twitter",
      "operationId": "twitter.community.get",
      "requiresApiKey": true,
      "creditsNote": "1 credit base (up to 1 credits on success). See `meta.creditsCharged`.",
      "docsPathname": "/docs/api/v1/twitter/communities/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/twitter/communities/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/twitter/communities/get.mdx",
      "sdkMethod": {
        "resource": "twitter",
        "methodName": "getCommunity",
        "signature": "client.twitter.getCommunity({ url })",
        "clientCall": "client.twitter.getCommunity({ url })"
      },
      "parameterNames": [
        "url"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Community URL to look up."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/twitter/communities/tweets",
      "summary": "List Twitter community tweets",
      "tag": "Twitter",
      "operationId": "twitter.community.tweets.list",
      "requiresApiKey": true,
      "creditsNote": "1 credit base (up to 1 credits on success). See `meta.creditsCharged`.",
      "docsPathname": "/docs/api/v1/twitter/communities/tweets/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/twitter/communities/tweets/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/twitter/communities/tweets/get.mdx",
      "sdkMethod": {
        "resource": "twitter",
        "methodName": "getCommunityTweets",
        "signature": "client.twitter.getCommunityTweets({ url })",
        "clientCall": "client.twitter.getCommunityTweets({ url })"
      },
      "parameterNames": [
        "url"
      ],
      "acceptedIdentifiers": [
        {
          "name": "url",
          "location": "query",
          "required": true,
          "type": "string",
          "description": "Community URL to look up."
        }
      ],
      "outcome": {
        "fieldPath": "data.lookupStatus",
        "values": [
          "found",
          "not_found"
        ]
      },
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/whoami",
      "summary": "Whoami",
      "tag": "Auth",
      "operationId": "auth.whoami",
      "requiresApiKey": true,
      "docsPathname": "/docs/api/v1/whoami",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/whoami",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/whoami.mdx",
      "sdkMethod": {
        "resource": "auth",
        "methodName": "whoami",
        "signature": "client.auth.whoami()",
        "clientCall": "client.auth.whoami()"
      },
      "parameterNames": [],
      "acceptedIdentifiers": [],
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/v1/balance",
      "summary": "Get account balance",
      "tag": "Auth",
      "operationId": "billing.balance.get",
      "requiresApiKey": true,
      "docsPathname": "/docs/api/v1/balance",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/v1/balance",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/v1/balance.mdx",
      "sdkMethod": {
        "resource": "billing",
        "methodName": "getBalance",
        "signature": "client.billing.getBalance()",
        "clientCall": "client.billing.getBalance()"
      },
      "parameterNames": [],
      "acceptedIdentifiers": [],
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    },
    {
      "method": "GET",
      "path": "/health",
      "summary": "Health check",
      "tag": "System",
      "operationId": "system.health",
      "requiresApiKey": false,
      "docsPathname": "/docs/api/health/get",
      "docsHtmlUrl": "https://www.socialfetch.dev/docs/api/health/get",
      "docsMarkdownUrl": "https://www.socialfetch.dev/docs/api/health/get.mdx",
      "sdkMethod": {
        "resource": "client",
        "methodName": "health",
        "signature": "client.health()",
        "clientCall": "client.health()"
      },
      "parameterNames": [],
      "acceptedIdentifiers": [],
      "sortByValues": [],
      "supportsTrim": false,
      "supportsMediaDownload": false
    }
  ]
}