Search Profiles

GET

/search/profiles

Searches for public social media profiles by name (Facebook) or exact username (Instagram).

The search uses a connected account from your workspace to query the social network's API. Your workspace must have at least one connected profile for the target network.

Instagram behaviour: Instagram's API only supports looking up exact usernames, and only for business or creator accounts. Use the area parameter to control how validation failures are handled:

area=insights (default) — throws a 400 error if the username is not found or is a personal account.

area=posts — returns an empty result with a warning field, allowing you to proceed at your own responsibility.

The id returned in the results is the internal profile identifier to use when creating a competitor via POST /competitor.

Request

Query Params

Header Params

Responses

🟢200

application/json

Bodyapplication/json

🟠400Profile not found or not a business account

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.swonkie.dev/v2/search/profiles?query=nike&net=instagram&area=insights' \
--header 'X-API-ID: ' \
--header 'X-API-KEY: '

Response Example

200 - 200 OK — profile found

{
    "items": [
        {
            "id": "UHJ0ZXdEWnMxV2ppVFNISDlZZlRWdz09",
            "name": "Nike",
            "username": "nike",
            "picture": "https://example.com/profiles/nike.jpg"
        }
    ]
}

Modified at 2026-06-22 13:58:53

Generate an Image

Profiles