Competitors

GET

/competitors

Retrieves a paginated list of all competitor profiles being monitored in your workspace. This endpoint allows you to track and analyze competitor social media accounts across multiple platforms, view their monitoring status, and access basic profile information for competitive intelligence purposes.

Request

Query Params

Header Params

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.swonkie.dev/v2/competitors?skip=0&take=10&query=Competitor%20Name&net=facebook%2Cinstagram' \
--header 'X-API-ID: ' \
--header 'X-API-KEY: '

Response Example

{
    "hasMore": false,
    "items": [
        {
            "id": "RDlHZERwbitlK1lmQU0xNW0zWUhWZz09",
            "name": "Nike",
            "username": "nike",
            "picture": "https://storage.example.com/profiles/nike123.jpg",
            "net": {
                "name": "Instagram",
                "code": "instagram"
            },
            "statusLevel": "ACTIVE"
        },
        {
            "id": "Tjg3YjhSU2xZREFqM1RqOTRnZTdpZz09",
            "name": "Nike Official",
            "username": "nike",
            "picture": "https://storage.example.com/profiles/nike456.jpg",
            "net": {
                "name": "Facebook",
                "code": "facebook"
            },
            "statusLevel": "NOT_AVAILABLE"
        }
    ],
    "total": 2
}

Modified at 2026-06-30 17:47:30

My Profiles

Add Competitor