Streamlivr

{
  "protocolVersion": "0.3.0",
  "name": "Streamlivr",
  "description": "Streamlivr sells African and global creator, brand, music, content and platform metadata over x402 on Celo. Agents can search and page through public creator and brand profiles, public content and the music catalog, at one cent per creator credited. Every settled payment is attributed back to the creators whose rows were served: a post pays whoever owns its audio rather than whoever posted it, a recording pays the artist who owns it rather than the accounts that used it, and a row with no Streamlivr owner is retained by the platform.",
  "url": "https://api.streamlivr.com",
  "iconUrl": "https://streamlivr.com/assets/STREAMLIVR%20ICON%20(1).png",
  "preferredTransport": "HTTP+JSON",
  "additionalInterfaces": [
    {
      "url": "https://api.streamlivr.com",
      "transport": "HTTP+JSON"
    }
  ],
  "version": "1.0.0",
  "provider": {
    "organization": "Streamlivr",
    "url": "https://streamlivr.com"
  },
  "documentationUrl": "https://github.com/streamlivr/streamlivr-x402-celo",
  "openapiUrl": "https://api.streamlivr.com/openapi.json",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "extensions": [
      {
        "uri": "https://github.com/coinbase/x402",
        "description": "Every skill on this agent is paid with an x402 exact-scheme transfer on Celo.",
        "required": true,
        "params": {
          "x402Version": 2,
          "scheme": "exact",
          "network": "eip155:42220",
          "chainId": 42220,
          "asset": "USDC",
          "assetAddress": "0xcebA9300f2b948710d2653dD7B07f33A8B32118C",
          "payTo": "0x4503F32dFF9e54Ee4c0Fd9BE25bCC662abB4c4Bf",
          "facilitator": "https://api.x402.celo.org",
          "routes": [
            {
              "id": "x402-ping",
              "name": "streamlivr-ping",
              "method": "GET",
              "url": "https://api.streamlivr.com/api/v1/agent/ping",
              "path": "/api/v1/agent/ping",
              "description": "Returns liveness and the settlement network the API is running on. Use it to confirm a buyer wallet, facilitator key, and x402 client all work before paying for data.",
              "tags": [
                "x402",
                "celo",
                "health",
                "0.01-usdc"
              ],
              "queryParams": [],
              "price": {
                "amountAtomic": "10000",
                "amount": "0.01",
                "decimals": 6,
                "asset": "USDC",
                "assetAddress": "0xcebA9300f2b948710d2653dD7B07f33A8B32118C",
                "network": "eip155:42220",
                "payTo": "0x4503F32dFF9e54Ee4c0Fd9BE25bCC662abB4c4Bf",
                "billedPer": "request",
                "unitAtomic": "10000",
                "maximumAtomic": "10000",
                "rule": "One cent in USDC per creator credited, with a one cent minimum per request. A page that credits 50 creators costs $0.50. The 402 invoice carries the exact amount before anything is signed."
              }
            },
            {
              "id": "creator-listings",
              "name": "streamlivr-listings",
              "method": "GET",
              "url": "https://api.streamlivr.com/api/v1/agent/listings?q=lagos&limit=10",
              "path": "/api/v1/agent/listings",
              "description": "Public creator and brand profiles: name, bio, avatar, country, follower counts, verification and account age. Searchable by name, bio, hashtag and country with ?q=. Combine with ?limit=, ?verified=, ?minFollowers= and ?sort=followers|newest. The response includes the total and nextCursor. Priced per creator credited. One cent in USDC per creator credited, with a one cent minimum per request. A page that credits 50 creators costs $0.50. The 402 invoice carries the exact amount before anything is signed.",
              "tags": [
                "x402",
                "celo",
                "creators",
                "brands",
                "africa",
                "global",
                "discovery",
                "search",
                "0.01-usdc"
              ],
              "queryParams": [
                {
                  "name": "q",
                  "description": "Free-text search. Matches names, titles, bios, hashtags, country names and country codes on that route. Omit to list everything.",
                  "example": "lagos",
                  "type": "string"
                },
                {
                  "name": "limit",
                  "description": "Rows to return, 1-200, default 10. This is the cost control: the invoice is one cent per creator the page credits, so a bigger page costs more.",
                  "example": "10",
                  "type": "integer"
                },
                {
                  "name": "cursor",
                  "description": "nextCursor from the previous page. Omit for the first page.",
                  "example": "eyJpZCI6ImNtbWdnYnRpazAwMDBxcnFiem9udHZzeTM4In0",
                  "type": "string"
                },
                {
                  "name": "verified",
                  "description": "Filter public creators by verified status. Omit for both.",
                  "example": "true",
                  "type": "boolean"
                },
                {
                  "name": "minFollowers",
                  "description": "Minimum public follower count, 0-2147483647.",
                  "example": "1000",
                  "type": "integer"
                },
                {
                  "name": "sort",
                  "description": "Follower count descending (default) or newest account first.",
                  "example": "followers",
                  "type": "string",
                  "values": [
                    "followers",
                    "newest"
                  ]
                }
              ],
              "price": {
                "amountAtomic": "10000",
                "amount": "0.01",
                "decimals": 6,
                "asset": "USDC",
                "assetAddress": "0xcebA9300f2b948710d2653dD7B07f33A8B32118C",
                "network": "eip155:42220",
                "payTo": "0x4503F32dFF9e54Ee4c0Fd9BE25bCC662abB4c4Bf",
                "billedPer": "creator credited",
                "unitAtomic": "10000",
                "maximumAtomic": "2000000",
                "rule": "One cent in USDC per creator credited, with a one cent minimum per request. A page that credits 50 creators costs $0.50. The 402 invoice carries the exact amount before anything is signed."
              }
            },
            {
              "id": "public-posts",
              "name": "streamlivr-posts",
              "method": "GET",
              "url": "https://api.streamlivr.com/api/v1/agent/posts?q=lagos&limit=10",
              "path": "/api/v1/agent/posts",
              "description": "Published public content from every public account: title, caption, hashtags, media type and length, engagement counts, and thumbnail. Each row labels the audio owner and attribution; borrowed sound credits its owner. Searchable by title, caption, tag or the public creator's country with ?q=. Combine with ?limit= and ?sort=newest|views, and follow nextCursor for more. Priced per creator credited. One cent in USDC per creator credited, with a one cent minimum per request. A page that credits 50 creators costs $0.50. The 402 invoice carries the exact amount before anything is signed.",
              "tags": [
                "x402",
                "celo",
                "posts",
                "content",
                "africa",
                "global",
                "brands",
                "engagement",
                "search",
                "0.01-usdc"
              ],
              "queryParams": [
                {
                  "name": "q",
                  "description": "Free-text search. Matches names, titles, bios, hashtags, country names and country codes on that route. Omit to list everything.",
                  "example": "lagos",
                  "type": "string"
                },
                {
                  "name": "limit",
                  "description": "Rows to return, 1-200, default 10. This is the cost control: the invoice is one cent per creator the page credits, so a bigger page costs more.",
                  "example": "10",
                  "type": "integer"
                },
                {
                  "name": "cursor",
                  "description": "nextCursor from the previous page. Omit for the first page.",
                  "example": "eyJpZCI6ImNtbWdnYnRpazAwMDBxcnFiem9udHZzeTM4In0",
                  "type": "string"
                },
                {
                  "name": "sort",
                  "description": "Newest first (default) or public view count descending.",
                  "example": "views",
                  "type": "string",
                  "values": [
                    "newest",
                    "views"
                  ]
                }
              ],
              "price": {
                "amountAtomic": "10000",
                "amount": "0.01",
                "decimals": 6,
                "asset": "USDC",
                "assetAddress": "0xcebA9300f2b948710d2653dD7B07f33A8B32118C",
                "network": "eip155:42220",
                "payTo": "0x4503F32dFF9e54Ee4c0Fd9BE25bCC662abB4c4Bf",
                "billedPer": "creator credited",
                "unitAtomic": "10000",
                "maximumAtomic": "2000000",
                "rule": "One cent in USDC per creator credited, with a one cent minimum per request. A page that credits 50 creators costs $0.50. The 402 invoice carries the exact amount before anything is signed."
              }
            },
            {
              "id": "music-catalog",
              "name": "streamlivr-catalog",
              "method": "GET",
              "url": "https://api.streamlivr.com/api/v1/agent/catalog?q=lagos&limit=10",
              "path": "/api/v1/agent/catalog",
              "description": "Music and audio metadata for African and global repertoire: title, artist, ISRC, artwork, and a playable preview clip when the source provides one. Each row carries a \"label\" block that names its owner and how many public posts draw on it, and an \"attribution\" note. A recording is credited to the artist who owns it, never to the accounts whose posts used it; a recording with no Streamlivr owner is retained by the platform. Searchable by title or artist with ?q= and paginated. Matches how the Streamlivr app indexes audio for video, so agent results line up with in-app search. Priced per creator credited and attributed to each one when the payment settles. One cent in USDC per creator credited, with a one cent minimum per request. A page that credits 50 creators costs $0.50. The 402 invoice carries the exact amount before anything is signed.",
              "tags": [
                "x402",
                "celo",
                "music",
                "audio",
                "metadata",
                "isrc",
                "africa",
                "global",
                "search",
                "0.01-usdc"
              ],
              "queryParams": [
                {
                  "name": "q",
                  "description": "Free-text search. Matches names, titles, bios, hashtags, country names and country codes on that route. Omit to list everything.",
                  "example": "lagos",
                  "type": "string"
                },
                {
                  "name": "limit",
                  "description": "Rows to return, 1-200, default 10. This is the cost control: the invoice is one cent per creator the page credits, so a bigger page costs more.",
                  "example": "10",
                  "type": "integer"
                },
                {
                  "name": "cursor",
                  "description": "nextCursor from the previous page. Omit for the first page.",
                  "example": "eyJpZCI6ImNtbWdnYnRpazAwMDBxcnFiem9udHZzeTM4In0",
                  "type": "string"
                }
              ],
              "price": {
                "amountAtomic": "10000",
                "amount": "0.01",
                "decimals": 6,
                "asset": "USDC",
                "assetAddress": "0xcebA9300f2b948710d2653dD7B07f33A8B32118C",
                "network": "eip155:42220",
                "payTo": "0x4503F32dFF9e54Ee4c0Fd9BE25bCC662abB4c4Bf",
                "billedPer": "creator credited",
                "unitAtomic": "10000",
                "maximumAtomic": "2000000",
                "rule": "One cent in USDC per creator credited, with a one cent minimum per request. A page that credits 50 creators costs $0.50. The 402 invoice carries the exact amount before anything is signed."
              }
            },
            {
              "id": "creator-profile",
              "name": "streamlivr-creator-profile",
              "method": "GET",
              "url": "https://api.streamlivr.com/api/v1/agent/creator/cmmggbkik0000rqbzontvsy38",
              "path": "/api/v1/agent/creator/:id",
              "description": "One public creator or brand profile by id, with the counts of their published content and catalogued tracks. One creator, so one cent, which is the cheapest way to buy when the agent already knows which profile it needs.",
              "tags": [
                "x402",
                "celo",
                "creators",
                "brands",
                "profile",
                "0.01-usdc"
              ],
              "queryParams": [],
              "price": {
                "amountAtomic": "10000",
                "amount": "0.01",
                "decimals": 6,
                "asset": "USDC",
                "assetAddress": "0xcebA9300f2b948710d2653dD7B07f33A8B32118C",
                "network": "eip155:42220",
                "payTo": "0x4503F32dFF9e54Ee4c0Fd9BE25bCC662abB4c4Bf",
                "billedPer": "request",
                "unitAtomic": "10000",
                "maximumAtomic": "10000",
                "rule": "One cent in USDC per creator credited, with a one cent minimum per request. A page that credits 50 creators costs $0.50. The 402 invoice carries the exact amount before anything is signed."
              }
            }
          ]
        }
      },
      {
        "uri": "https://eips.ethereum.org/EIPS/eip-8004",
        "description": "Agent identity and buyer reputation on the Celo ERC-8004 registries.",
        "required": false,
        "params": {
          "agentId": "9852",
          "chainId": 42220,
          "network": "celo-mainnet",
          "identityRegistry": "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
          "reputationRegistry": "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63",
          "registrationUrl": "https://8004scan.io/agents/celo/9852",
          "reputationUrl": "https://api.streamlivr.com/api/v1/agent/reputation"
        }
      }
    ]
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "x402-ping",
      "name": "Payment connectivity check",
      "description": "Returns liveness and the settlement network the API is running on. Use it to confirm a buyer wallet, facilitator key, and x402 client all work before paying for data.",
      "tags": [
        "x402",
        "celo",
        "health",
        "0.01-usdc"
      ],
      "examples": [
        "GET https://api.streamlivr.com/api/v1/agent/ping"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "creator-listings",
      "name": "Creator and brand directory",
      "description": "Public creator and brand profiles: name, bio, avatar, country, follower counts, verification and account age. Searchable by name, bio, hashtag and country with ?q=. Combine with ?limit=, ?verified=, ?minFollowers= and ?sort=followers|newest. The response includes the total and nextCursor. Priced per creator credited. One cent in USDC per creator credited, with a one cent minimum per request. A page that credits 50 creators costs $0.50. The 402 invoice carries the exact amount before anything is signed.",
      "tags": [
        "x402",
        "celo",
        "creators",
        "brands",
        "africa",
        "global",
        "discovery",
        "search",
        "0.01-usdc"
      ],
      "examples": [
        "GET https://api.streamlivr.com/api/v1/agent/listings?q=lagos&limit=10"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "public-posts",
      "name": "Public content feed",
      "description": "Published public content from every public account: title, caption, hashtags, media type and length, engagement counts, and thumbnail. Each row labels the audio owner and attribution; borrowed sound credits its owner. Searchable by title, caption, tag or the public creator's country with ?q=. Combine with ?limit= and ?sort=newest|views, and follow nextCursor for more. Priced per creator credited. One cent in USDC per creator credited, with a one cent minimum per request. A page that credits 50 creators costs $0.50. The 402 invoice carries the exact amount before anything is signed.",
      "tags": [
        "x402",
        "celo",
        "posts",
        "content",
        "africa",
        "global",
        "brands",
        "engagement",
        "search",
        "0.01-usdc"
      ],
      "examples": [
        "GET https://api.streamlivr.com/api/v1/agent/posts?q=lagos&limit=10"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "music-catalog",
      "name": "Music and audio metadata",
      "description": "Music and audio metadata for African and global repertoire: title, artist, ISRC, artwork, and a playable preview clip when the source provides one. Each row carries a \"label\" block that names its owner and how many public posts draw on it, and an \"attribution\" note. A recording is credited to the artist who owns it, never to the accounts whose posts used it; a recording with no Streamlivr owner is retained by the platform. Searchable by title or artist with ?q= and paginated. Matches how the Streamlivr app indexes audio for video, so agent results line up with in-app search. Priced per creator credited and attributed to each one when the payment settles. One cent in USDC per creator credited, with a one cent minimum per request. A page that credits 50 creators costs $0.50. The 402 invoice carries the exact amount before anything is signed.",
      "tags": [
        "x402",
        "celo",
        "music",
        "audio",
        "metadata",
        "isrc",
        "africa",
        "global",
        "search",
        "0.01-usdc"
      ],
      "examples": [
        "GET https://api.streamlivr.com/api/v1/agent/catalog?q=lagos&limit=10"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "creator-profile",
      "name": "Creator profile",
      "description": "One public creator or brand profile by id, with the counts of their published content and catalogued tracks. One creator, so one cent, which is the cheapest way to buy when the agent already knows which profile it needs.",
      "tags": [
        "x402",
        "celo",
        "creators",
        "brands",
        "profile",
        "0.01-usdc"
      ],
      "examples": [
        "GET https://api.streamlivr.com/api/v1/agent/creator/cmmggbkik0000rqbzontvsy38"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ],
  "supportsAuthenticatedExtendedCard": false,
  "paymentEnabled": true
}