Circles Documentation
  • Welcome to Circles
  • Overview
    • Understanding Personal and Group Currencies
      • Personal Currencies
      • Group Currencies
    • Why Build on Circles?
    • Circles Architecture
  • Developer Docs
    • The Circles Stack
    • Circles SDK Overview
    • Quickstart Guide for Circles SDK
    • Setting Circles Profiles
    • Building with different Circles Avatars
      • Personal / Human Avatars
        • Inviting and accepting human avatars
        • Mint personal tokens
        • Fetching profile of an human avatar
        • Manage trust connections
        • Get token balances of an avatar
        • Transfer personal Circles tokens to different avatar
      • Group Avatars
        • Create Base Groups for your community.
          • Vanilla groups with V2 hub
        • Mint group tokens
        • Managing group invites
        • Find groups and memberships
        • Getting total supply of group tokens available
      • Organization Avatars
        • Creation of Organizations
        • Managing trust connections via Org avatar account
  • Tutorials and Examples
    • Setting up Circles SDK with React
  • Querying Circles profiles and data
    • Query Circles Data
    • Subscribing to Avatar events
    • Utilising CirclesQuery Class
    • Query Circles profiles
  • Circles SDK Reference
    • Circles SDK interface
    • SDK Methods
    • Circles Data Methods
    • Circles Events Types
  • Developer Support
    • Glossary
    • Past Hackathon Projects on Circles
Powered by GitBook
On this page
  • Query Circles Profiles
  • 1. Create a Profile (POST request)
  • 2. Get a Profile by CID (GET request)
  • 3. Get Multiple Profiles by CIDs (GET request)
  • 4. Search Profiles by Name (GET request)
  • 5. Search Profiles by Description (GET request)
  • 6. Search Profiles by Address (GET request)
  • 7. Search Profiles by CID (GET request)
  • 8. Search Profiles with Multiple Criteria (GET request)

Was this helpful?

Export as PDF
  1. Querying Circles profiles and data

Query Circles profiles

PreviousUtilising CirclesQuery ClassNextCircles SDK interface

Last updated 3 months ago

Was this helpful?

Query Circles Profiles

Retrieve user profile data using the Profiles Nethermind plugin. You can:

  • Create new user profiles

  • Search existing profiles using parameters such as:

    • Name

    • CID (Content Identifier)

    • Description

    • Wallet Address

1. Create a Profile (POST request)

curl -X POST "https://rpc.aboutcircles.com/profiles/pin" \
     -H "Content-Type: application/json" \
     -d '{
           "name": "John Doe",
           "description": "A blockchain developer",
           "previewImageUrl": "https://example.com/preview.jpg",
           "imageUrl": "https://example.com/image.jpg",
           "extensions": {
             "twitter": "@johndoe",
             "github": "johndoe"
           }
         }'

2. Get a Profile by CID (GET request)

curl -X GET "https://rpc.aboutcircles.com/profiles/get?cid=Qm12345abcdef"

3. Get Multiple Profiles by CIDs (GET request)

curl -X GET "https://rpc.aboutcircles.com/profiles/getBatch?cids=Qm12345abcdef,Qm678bbdj

4. Search Profiles by Name (GET request)

curl -X GET "https://rpc.aboutcircles.com/profiles/search?name=John"

5. Search Profiles by Description (GET request)

curl -X GET "https://rpc.aboutcircles.com/profiles/search?description=Circles"

6. Search Profiles by Address (GET request)

curl -X GET "https://rpc.aboutcircles.com/profiles/search?address=0x1234567890abcdef"

7. Search Profiles by CID (GET request)

curl -X GET "https://rpc.aboutcircles.com/profiles/search?CID=Qm12345abcdef"

8. Search Profiles with Multiple Criteria (GET request)

curl -X GET "https://rpc.aboutcircles.com/profiles/search?name=John&description=blockchain&address=0x1234567890abcdef&CID=Qm12345abcdef"
💡