{
  "x402Version": 2,
  "id": 29623,
  "slug": "29623",
  "resource": "https://api.socialfetch.dev/v1/twitter/profiles/:handle",
  "description": "Get an X (Twitter) profile by handle or numeric user id.",
  "type": "http",
  "serviceName": "SocialFetch",
  "resourceType": "Identity & Enrichment",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0x02C2fCAfCe36B4AAdB39625866Bc6B1699d83043",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "14000",
      "amountUsd": 0.014,
      "maxTimeoutSeconds": 300
    }
  ],
  "outputSchema": {
    "properties": {
      "example": {
        "type": "object"
      },
      "type": {
        "type": "string"
      }
    },
    "required": [
      "type"
    ],
    "type": "object"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "method": "GET",
          "pathParams": {
            "handle": "zcash"
          },
          "queryParams": {},
          "type": "http"
        },
        "output": {
          "example": {
            "data": {
              "lookupStatus": "found",
              "metrics": {
                "favourites": 16987,
                "followers": 92390102,
                "following": 117,
                "listedCount": 96930,
                "mediaCount": 28139,
                "tweets": 74284
              },
              "profile": {
                "_truncated": true,
                "accountCreatedAt": "2007-12-19T20:20:32.000Z",
                "avatarUrl": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_400x400.jpg",
                "bannerUrl": "https://pbs.twimg.com/profile_banners/11348282/1788992290/1500x500",
                "bio": "Making the seemingly impossible, possible. ✨",
                "blueVerified": true,
                "displayName": "NASA",
                "handle": "NASA",
                "platform": "twitter",
                "platformUserId": "11348282",
                "privateAccount": false,
                "profileUrl": "https://x.com/NASA",
                "verified": false
              }
            },
            "meta": {
              "creditsCharged": 1,
              "requestId": "req_example_twitter_profile",
              "version": "v1"
            }
          },
          "type": "json"
        }
      },
      "routeTemplate": "/v1/twitter/profiles/:handle",
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "method": {
                "enum": [
                  "GET"
                ],
                "type": "string"
              },
              "pathParams": {
                "properties": {
                  "handle": {
                    "description": "X (Twitter) profile handle without the leading @, or a numeric user id.",
                    "type": "string"
                  }
                },
                "required": [
                  "handle"
                ],
                "type": "object"
              },
              "queryParams": {
                "properties": {
                  "by": {
                    "description": "Treat the path value as a handle or a numeric user id. Defaults to id when the value is all digits.",
                    "enum": [
                      "id",
                      "handle"
                    ],
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method"
            ],
            "type": "object"
          },
          "output": {
            "properties": {
              "example": {
                "type": "object"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      }
    },
    "payment-identifier": {
      "info": {
        "required": false
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "id": {
            "maxLength": 128,
            "minLength": 16,
            "pattern": "^[a-zA-Z0-9_-]+$",
            "type": "string"
          },
          "required": {
            "type": "boolean"
          }
        },
        "required": [
          "required"
        ],
        "type": "object"
      }
    }
  },
  "tags": [
    "Twitter",
    "social-data",
    "bazaar",
    "payment-identifier"
  ],
  "sourceHost": "api.socialfetch.dev",
  "lastUpdated": "2026-10-02T18:09:01Z",
  "quality": {
    "calls30d": 1,
    "uniquePayers30d": 1,
    "lastCalledAt": "2026-10-02T18:09:00.7Z"
  },
  "metadata": {
    "serviceName": "SocialFetch",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "method": "GET",
            "pathParams": {
              "handle": "zcash"
            },
            "queryParams": {},
            "type": "http"
          },
          "output": {
            "example": {
              "data": {
                "lookupStatus": "found",
                "metrics": {
                  "favourites": 16987,
                  "followers": 92390102,
                  "following": 117,
                  "listedCount": 96930,
                  "mediaCount": 28139,
                  "tweets": 74284
                },
                "profile": {
                  "_truncated": true,
                  "accountCreatedAt": "2007-12-19T20:20:32.000Z",
                  "avatarUrl": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_400x400.jpg",
                  "bannerUrl": "https://pbs.twimg.com/profile_banners/11348282/1788992290/1500x500",
                  "bio": "Making the seemingly impossible, possible. ✨",
                  "blueVerified": true,
                  "displayName": "NASA",
                  "handle": "NASA",
                  "platform": "twitter",
                  "platformUserId": "11348282",
                  "privateAccount": false,
                  "profileUrl": "https://x.com/NASA",
                  "verified": false
                }
              },
              "meta": {
                "creditsCharged": 1,
                "requestId": "req_example_twitter_profile",
                "version": "v1"
              }
            },
            "type": "json"
          }
        },
        "routeTemplate": "/v1/twitter/profiles/:handle",
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "properties": {
            "input": {
              "additionalProperties": false,
              "properties": {
                "method": {
                  "enum": [
                    "GET"
                  ],
                  "type": "string"
                },
                "pathParams": {
                  "properties": {
                    "handle": {
                      "description": "X (Twitter) profile handle without the leading @, or a numeric user id.",
                      "type": "string"
                    }
                  },
                  "required": [
                    "handle"
                  ],
                  "type": "object"
                },
                "queryParams": {
                  "properties": {
                    "by": {
                      "description": "Treat the path value as a handle or a numeric user id. Defaults to id when the value is all digits.",
                      "enum": [
                        "id",
                        "handle"
                      ],
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "type": {
                  "const": "http",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "method"
              ],
              "type": "object"
            },
            "output": {
              "properties": {
                "example": {
                  "type": "object"
                },
                "type": {
                  "type": "string"
                }
              },
              "required": [
                "type"
              ],
              "type": "object"
            }
          },
          "required": [
            "input"
          ],
          "type": "object"
        }
      },
      "payment-identifier": {
        "info": {
          "required": false
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "properties": {
            "id": {
              "maxLength": 128,
              "minLength": 16,
              "pattern": "^[a-zA-Z0-9_-]+$",
              "type": "string"
            },
            "required": {
              "type": "boolean"
            }
          },
          "required": [
            "required"
          ],
          "type": "object"
        }
      }
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": false,
  "featured": false,
  "provider": {
    "host": "api.socialfetch.dev",
    "manifest_name": "api.socialfetch.dev",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-10-14T01:15:01.050Z"
  },
  "exampleResponse": {
    "data": {
      "lookupStatus": "found",
      "metrics": {
        "favourites": 16987,
        "followers": 92390102,
        "following": 117,
        "listedCount": 96930,
        "mediaCount": 28139,
        "tweets": 74284
      },
      "profile": {
        "_truncated": true,
        "accountCreatedAt": "2007-12-19T20:20:32.000Z",
        "avatarUrl": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_400x400.jpg",
        "bannerUrl": "https://pbs.twimg.com/profile_banners/11348282/1788992290/1500x500",
        "bio": "Making the seemingly impossible, possible. ✨",
        "blueVerified": true,
        "displayName": "NASA",
        "handle": "NASA",
        "platform": "twitter",
        "platformUserId": "11348282",
        "privateAccount": false,
        "profileUrl": "https://x.com/NASA",
        "verified": false
      }
    },
    "meta": {
      "creditsCharged": 1,
      "requestId": "req_example_twitter_profile",
      "version": "v1"
    }
  }
}