Social Fetch
Instagram

Search Instagram profiles

Search Instagram profiles by keyword.

Use GET /v1/instagram/profiles/{handle} when you already know the username. Use this endpoint to discover profiles by keyword.

An empty profiles array means no matching public profiles were found for this query and page. Results are best-effort from publicly indexed Instagram pages and are not a complete native Instagram directory.

GET/v1/instagram/search/profiles
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
2
query*stringquery

Search query text for Instagram profiles.

min 1 chars · max 512 chars

cursorstringoptionalquery

Opaque pagination cursor returned by a previous response.

min 1 chars

Response fields
32

Endpoint-specific response payload.

dataquery
string

Search query that was evaluated for this response.

Profiles returned for the search query.

dataprofiles[]platform
string

Social platform for this profile.

one of: instagram

dataprofiles[]handle
string

Instagram username without the leading @.

min 1 chars

dataprofiles[]displayName
stringnullable

Public display name shown for the profile, when available.

dataprofiles[]bio
stringnullable

Profile biography text, when available.

dataprofiles[]avatarUrl
stringnullable

Profile image URL for the profile, when available.

dataprofiles[]verified
boolean

Whether Instagram marks the profile as verified.

dataprofiles[]profileUrl
string

Canonical public Instagram profile URL.

min 1 chars

dataprofiles[]privateAccount
boolean

Whether the account is private.

dataprofiles[]platformUserId
stringoptional

Instagram numeric user id as a string when available.

dataprofiles[]businessAccount
booleanoptional

Whether the account is a business account.

dataprofiles[]professionalAccount
booleanoptional

Whether the account is a professional/creator account.

dataprofiles[]categoryName
stringnullableoptional

Category label when Instagram provides one.

dataprofiles[]externalUrl
stringnullableoptional

Primary external link from the profile.

Structured bio links when available.

dataprofiles[]bioLinks[]title
stringnullable

Link title shown on the profile.

dataprofiles[]bioLinks[]url
string

Destination URL.

min 1 chars

dataprofiles[]matchedFrom
stringoptional

Whether the match came from the profile page or from caption text.

one of: profile, caption

Public profile metrics returned with this search result.

dataprofiles[]metricsfollowers
integernullable

Follower count when available.

≥ 0

dataprofiles[]metricsfollowing
integernullable

Following count when available.

≥ 0

dataprofiles[]metricsposts
integernullable

Public post count when available.

≥ 0

datatotalProfiles
integer

Number of profiles returned in this response.

≥ 0

Pagination information for the current response.

datapagenextCursor
stringnullable

Cursor to pass in the next request when another page is available.

datapagehasMore
boolean

Whether another page of profiles is likely available.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/instagram/search/profiles?query=fitness coach" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Profile search results for the requested query.