> ## Documentation Index > Fetch the complete documentation index at: https://docs.revcenter.ai/llms.txt > Use this file to discover all available pages before exploring further. # Search people > Searches LinkedIn people by keyword, company, location, or name. At least one criterion other than `page` is required. Requires the `data:people:search` scope. ## OpenAPI ````yaml /openapi.json post /v1/data/people/search openapi: 3.1.0 info: title: Revcenter API description: >- Search, enrich, and activate people and companies. Two authentication surfaces share one host: the bearer-token API under `/v1` for server-to-server and agent use, and the workspace-session API under `/api` that the Revcenter app itself runs on. version: '2026-08-12' servers: - url: https://api.revcenter.ai description: Production security: - bearerAuth: [] tags: - name: Search description: Web search, search runs, results, exports, and shareable shortlists. - name: People description: Person search, profile enrichment, and the workspace contact pool. - name: Companies description: Company search, company enrichment, and org-chart people. - name: Campaigns description: Plan, publish, and launch outbound sequences on Smartlead and HeyReach. - name: Account description: Health, usage totals, and cost events. paths: /v1/data/people/search: post: tags: - People summary: Search people description: >- Searches LinkedIn people by keyword, company, location, or name. At least one criterion other than `page` is required. Requires the `data:people:search` scope. operationId: searchPeople parameters: - $ref: '#/components/parameters/IdempotencyKeyHeader' requestBody: required: true content: application/json: schema: type: object properties: search: type: string maxLength: 240 description: Free-text keyword search. examples: - wealth advisor currentCompany: type: string maxLength: 300 description: Current employer name. companyId: anyOf: - type: string maxLength: 120 - type: integer description: LinkedIn company identifier to scope the search to. location: type: string maxLength: 180 examples: - San Jose, CA geoId: anyOf: - type: string maxLength: 120 - type: integer description: LinkedIn geo identifier. More precise than `location`. firstName: type: string maxLength: 120 lastName: type: string maxLength: 120 page: type: integer minimum: 1 maximum: 100 default: 1 idempotencyKey: type: string minLength: 8 maxLength: 160 examples: byRoleAndCity: summary: Role and city value: search: wealth advisor location: San Jose, CA page: 1 byCompany: summary: Everyone at one employer value: currentCompany: Merrill Lynch location: California responses: '200': description: Matching profiles, one page at a time. content: application/json: schema: allOf: - $ref: '#/components/schemas/MeteredEnvelope' - type: object properties: data: type: object properties: profiles: type: array items: $ref: '#/components/schemas/PersonSearchResult' pagination: $ref: '#/components/schemas/ProviderPagination' response: type: object additionalProperties: true '400': $ref: '#/components/responses/InvalidRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/InsufficientScope' '424': $ref: '#/components/responses/ProviderUnavailable' '429': $ref: '#/components/responses/RateLimited' '502': $ref: '#/components/responses/ProviderError' security: - bearerAuth: [] components: parameters: IdempotencyKeyHeader: name: Idempotency-Key in: header required: false description: >- Deduplicates the billing event when a request is retried. Safe to send on every call. schema: type: string minLength: 8 maxLength: 160 schemas: MeteredEnvelope: type: object description: The standard success envelope for billed endpoints. properties: data: type: object meta: allOf: - $ref: '#/components/schemas/Meta' - type: object properties: usage: $ref: '#/components/schemas/Usage' PersonSearchResult: type: object description: >- A person as returned by search — enough to decide whether to spend an enrichment on them. properties: firstName: type: - string - 'null' lastName: type: - string - 'null' headline: type: - string - 'null' location: type: - string - 'null' publicIdentifier: type: - string - 'null' description: Pass to `GET /v1/data/people/{profileId}` to enrich. profileUrl: type: - string - 'null' format: uri photoUrl: type: - string - 'null' format: uri additionalProperties: true ProviderPagination: type: - object - 'null' description: Provider paging cursor, passed through untouched. additionalProperties: true Meta: type: object properties: request_id: type: string format: uuid description: >- Echoes an inbound `X-Request-Id` when you send one, otherwise generated. Always returned in the `X-Request-Id` header too. Usage: type: object description: What this single call cost. properties: operation: type: string examples: - data.people.profile acquisition_units: type: integer examples: - 10000 billable_units: type: integer examples: - 10000 funding_source: $ref: '#/components/schemas/FundingSource' Error: type: object description: The error shape used by every `/v1` endpoint. properties: error: type: object properties: code: type: string examples: - insufficient_scope message: type: string details: type: object additionalProperties: true meta: $ref: '#/components/schemas/Meta' FundingSource: type: string enum: - platform - workspace_byok description: >- `platform` means Revcenter's own provider keys paid for the call and it counts as billable acquisition. `workspace_byok` means your workspace's own provider key did — the activity is recorded, but the vendor spend is yours, not billable overage. responses: InvalidRequest: description: The request body failed validation. content: application/json: schema: $ref: '#/components/schemas/Error' examples: missingQuery: value: error: code: invalid_request message: query is required. meta: request_id: 6f1c2b7e-9a3d-4c5f-8e21-0b7d4a9c1e33 Unauthorized: description: No key, or the key is invalid, expired, or revoked. content: application/json: schema: $ref: '#/components/schemas/Error' examples: missing: value: error: code: missing_api_key message: 'Send Authorization: Bearer rvc_live_...' meta: request_id: 6f1c2b7e-9a3d-4c5f-8e21-0b7d4a9c1e33 invalid: value: error: code: invalid_api_key message: API key is invalid, expired, or revoked. meta: request_id: 6f1c2b7e-9a3d-4c5f-8e21-0b7d4a9c1e33 InsufficientScope: description: The key authenticated but lacks the scope this endpoint requires. content: application/json: schema: $ref: '#/components/schemas/Error' examples: scope: value: error: code: insufficient_scope message: API key requires scope 'data:people:read'. meta: request_id: 6f1c2b7e-9a3d-4c5f-8e21-0b7d4a9c1e33 ProviderUnavailable: description: >- The workspace has no usable provider key for this capability — it is either unprovisioned or switched off. content: application/json: schema: $ref: '#/components/schemas/Error' examples: unavailable: value: error: code: provider_unavailable message: Web search is unavailable for this workspace. meta: request_id: 6f1c2b7e-9a3d-4c5f-8e21-0b7d4a9c1e33 RateLimited: description: >- The key exceeded its per-minute limit. Check `X-RateLimit-Reset` for when the window rolls over. content: application/json: schema: $ref: '#/components/schemas/Error' examples: limited: value: error: code: rate_limited message: API key rate limit exceeded. meta: request_id: 6f1c2b7e-9a3d-4c5f-8e21-0b7d4a9c1e33 ProviderError: description: The upstream data source failed. Nothing is billed. content: application/json: schema: $ref: '#/components/schemas/Error' examples: upstream: value: error: code: provider_error message: Harvest profile request failed meta: request_id: 6f1c2b7e-9a3d-4c5f-8e21-0b7d4a9c1e33 securitySchemes: bearerAuth: type: http scheme: bearer description: >- A Revcenter API key: `Authorization: Bearer rvc_live_...`. Keys are scoped, rate limited per key, and metered per workspace. ````