Directory Search

The directory search endpoint lets you find professionals on PingRep without authentication. Use it to build people finders, integrate professional search into your app, or power team discovery tools.

GET

/api/v1/public/directory/search

Public

Search the public professional directory by role, location, or keyword.

Query parameters

rolestringOptional

Filter by professional role or job title (partial match supported).

locationstringOptional

Filter by city, state, or country.

querystringOptional

Free-text search across name, title, company, and bio.

limitnumberOptional

Maximum results to return. Defaults to 10, max 50.

Combine parameters

All query parameters are optional and can be combined. For example, searching for role=engineer&location=Dubai returns engineers based in Dubai.

Response

resultsarrayRequired

Array of matching professional profiles.

namestringRequired

Full name of the professional.

slugstringRequired

URL-safe identifier used in the profile URL.

titlestringRequired

Professional title or role.

companystringRequired

Company or organization name.

photoUrlstringRequired

URL to the profile photo.

locationstringRequired

Geographic location.

activeIdentitiesnumberRequired

Number of active professional identities.

totalnumberRequired

Total number of matching results (may exceed the limit).

Examples

Example response

Only published, public profiles appear in directory search results. Draft or private profiles are never included.