> ## Documentation Index
> Fetch the complete documentation index at: https://docs.airscale.io/llms.txt
> Use this file to discover all available pages before exploring further.

# People URL finder

> Find a professional profile URL from person and company details. Rate limit: 6 requests per second per workspace.

Identify a person by first name, last name, and company, then return a matching professional profile URL when one is found.

> [!NOTE]
>
> The limit is 6 requests per second per workspace. A successful result costs 0.5 credits; `not_found` is not charged.

After a `429 Too Many Requests` response, retry in a later second with bounded exponential backoff. For temporary `502` or `503` responses, retry the same input with increasing delays and a fixed retry limit; contact support if errors persist.

## Next step

Pass the matched URL to [Email finder](https://docs.airscale.io/api-reference/email-finder.md) for professional email enrichment.


## OpenAPI

````yaml openapi.json POST /v1/url-search-people
openapi: 3.1.0
info:
  title: Airscale Public API
  version: '2026-09-11'
  description: >-
    Search, enrich, resolve public business data, and monitor job changes with
    Airscale.
  x-airscale-source-repository: ViceScale/airscale-code
  x-airscale-source-sha: 1de19e1b70a052a4b8d9c2075021a7e5e7a94d51
servers:
  - url: https://api.airscale.io
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Search and discovery
    description: Search people, companies, and the web.
  - name: Contact data
    description: Find professional and personal contact data.
  - name: Profiles and reverse lookup
    description: Extract profiles or resolve a person from known contact data.
  - name: Post engagement
    description: Retrieve and enrich people who liked or commented on LinkedIn posts.
  - name: LinkedIn content
    description: >-
      Search LinkedIn posts, read profile and company feeds, and retrieve
      profile comments and comment reactions.
  - name: Job change monitoring
    description: Track LinkedIn profiles and receive job-change events.
  - name: New hire monitoring
    description: Watch companies or the market for people who start a matching role.
  - name: Post engagement monitoring
    description: >-
      Follow LinkedIn company pages and profiles and receive the people who
      engage with their posts.
  - name: Account
    description: Inspect workspace account state.
  - name: Miscellaneous
    description: >-
      Find website technologies and check WhatsApp availability, Meta ads, and
      email deliverability.
paths:
  /v1/url-search-people:
    post:
      tags:
        - Contact data
      summary: Find a person's profile URL
      description: Finds a person's public profile URL from their name and company name.
      operationId: findPeopleProfileUrl
      requestBody:
        required: true
        description: Provide the person's first name, last name, and company name.
        content:
          application/json:
            schema:
              type: object
              required:
                - first_name
                - last_name
                - company_name
              additionalProperties: false
              properties:
                first_name:
                  type: string
                  minLength: 1
                last_name:
                  type: string
                  minLength: 1
                company_name:
                  type: string
                  minLength: 1
            examples:
              person:
                summary: Synthetic person and company
                value:
                  first_name: Example
                  last_name: Person
                  company_name: Example Company
      responses:
        '200':
          description: A profile URL result or a not-found result.
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    required:
                      - status
                      - url
                    additionalProperties: true
                    properties:
                      status:
                        type: string
                        const: success
                      url:
                        type: string
                  - type: object
                    required:
                      - status
                    additionalProperties: true
                    properties:
                      status:
                        type: string
                        const: not_found
              examples:
                success:
                  summary: Profile URL found
                  value:
                    status: success
                    url: https://www.linkedin.com/in/example-person-000000
                notFound:
                  summary: No profile URL found
                  value:
                    status: not_found
        '400':
          description: >-
            The JSON body is invalid or required identification fields are
            missing.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          description: >-
            The workspace cannot complete this request because access or
            available credits are insufficient.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '413':
          description: The JSON request body exceeds the 256 KiB limit.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: >-
            The workspace rate limit has been exceeded. Try again after the
            current window resets.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: >-
            The request could not be completed because of an unexpected server
            error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '502':
          description: >-
            The request could not be completed because a required service
            returned an unsuccessful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: The request is temporarily unavailable. Try again later.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      additionalProperties: true
      properties:
        error:
          type: string
        message:
          type: string
  responses:
    Unauthorized:
      description: The Bearer token is missing or invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key
      description: >-
        Use an Airscale workspace API key. Never expose the key in client-side
        code.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.