Skip to main content
GET
/
identities
/
twitter
/
{username}
Get identity graph by Twitter username
curl --request GET \
  --url https://api.memoryproto.co/identities/twitter/{username} \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "5650",
    "platform": "farcaster",
    "url": "https://farcaster.xyz/vitalik.eth",
    "avatar": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/b663cd63-fecf-4d0f-7f87-0e0b6fd42800/original",
    "social": null,
    "username": "vitalik.eth",
    "sources": [
      {
        "id": "5650",
        "platform": "farcaster",
        "verified": true
      },
      {
        "id": "4458",
        "platform": "talent-protocol",
        "verified": true
      }
    ]
  },
  {
    "platform": "ens",
    "id": "vitalik.eth",
    "url": "https://app.ens.domains/vitalik.eth",
    "username": null,
    "avatar": "https://euc.li/vitalik.eth",
    "social": null,
    "sources": [
      {
        "id": "vitalik.eth",
        "platform": "ens",
        "verified": true
      }
    ]
  },
  {
    "id": "2230894",
    "username": "vbuterin",
    "url": "https://github.com/vbuterin",
    "avatar": "https://avatars.githubusercontent.com/u/2230894?v=4",
    "platform": "github",
    "social": {
      "verified": null,
      "followers": 12663,
      "following": 1
    },
    "sources": [
      {
        "id": "vitalik.eth",
        "platform": "ens",
        "verified": true
      }
    ]
  },
  {
    "id": "295218901",
    "username": "vitalikbuterin",
    "url": "https://x.com/vitalikbuterin",
    "avatar": "https://pbs.twimg.com/profile_images/1895872023944937472/Uoyc5-p8_normal.jpg",
    "platform": "twitter",
    "social": {
      "verified": true,
      "followers": 5755832,
      "following": 476
    },
    "sources": [
      {
        "id": "vitalik.eth",
        "platform": "ens",
        "verified": true
      }
    ]
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Authorization
string
required

Get your API key at https://memoryproto.co/developers.

Example:

"Bearer mem_xxx"

Path Parameters

​
username
string
required

The Twitter username of the user. For example, dwr or jessepollak.

Query Parameters

​
sources
string

Comma separated list of filtered sources

Example:

"farcaster,ens,talent-protocol"

​
verified
string

Filter verified data sources.

Response

Successful response containing the identity graph linked to the provided Twitter username.

​
id
string
required
​
username
string | null
required
​
url
string<uri> | null
required
​
avatar
string | null
required
​
platform
string
required
​
social
object
required
​
sources
object[]
required
Example:
[
  {
    "id": "5650",
    "platform": "farcaster",
    "url": "https://farcaster.xyz/vitalik.eth",
    "avatar": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/b663cd63-fecf-4d0f-7f87-0e0b6fd42800/original",
    "social": null,
    "username": "vitalik.eth",
    "sources": [
      {
        "id": "5650",
        "platform": "farcaster",
        "verified": true
      },
      {
        "id": "4458",
        "platform": "talent-protocol",
        "verified": true
      }
    ]
  },
  {
    "platform": "ens",
    "id": "vitalik.eth",
    "url": "https://app.ens.domains/vitalik.eth",
    "username": null,
    "avatar": "https://euc.li/vitalik.eth",
    "social": null,
    "sources": [
      {
        "id": "vitalik.eth",
        "platform": "ens",
        "verified": true
      }
    ]
  },
  {
    "id": "2230894",
    "username": "vbuterin",
    "url": "https://github.com/vbuterin",
    "avatar": "https://avatars.githubusercontent.com/u/2230894?v=4",
    "platform": "github",
    "social": {
      "verified": null,
      "followers": 12663,
      "following": 1
    },
    "sources": [
      {
        "id": "vitalik.eth",
        "platform": "ens",
        "verified": true
      }
    ]
  },
  {
    "id": "295218901",
    "username": "vitalikbuterin",
    "url": "https://x.com/vitalikbuterin",
    "avatar": "https://pbs.twimg.com/profile_images/1895872023944937472/Uoyc5-p8_normal.jpg",
    "platform": "twitter",
    "social": {
      "verified": true,
      "followers": 5755832,
      "following": 476
    },
    "sources": [
      {
        "id": "vitalik.eth",
        "platform": "ens",
        "verified": true
      }
    ]
  }
]