RecoupGet a free auditFree audit

API REFERENCE

People Search

On this page
POST/api/research/people

Search for people in the music industry — artists, managers, A&R reps, producers. Returns multi-source profiles including LinkedIn data.

Authentication

See the authentication guide for API key and account access requirements.

Request

cURL
curl --request POST \
  --url 'https://api.recoupable.dev/api/research/people' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "string"
}'

Try it

Fill in the fields, send the request from your browser, and read the live response. The curl below updates as you type.

Kept in this browser tab only and cleared when it closes.

cURL for this request
curl --request POST \
  --url 'https://recoup-api.vercel.app/api/research/people' \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "string"
}'

Request body required

application/json

querystringrequired

Natural language search for people (e.g., "A&R reps at Atlantic Records").

num_resultsinteger

Number of results to return.

Default: 10

minimum: 1 · maximum: 100

Responses

200People search results

application/json

statusstring · enum

Values: "success", "error"

resultsarray<ResearchPeopleResult>
Item properties for results
titlestring

Person name and role.

urlstring

Profile URL (often LinkedIn).

format: uri

idstring

Unique result identifier from the search provider.

publishedDatestringnullable

Date the profile or page was published.

authorstringnullable

Author of the page, if available.

highlightsarray<string>nullable

Key excerpts from the profile.

Item properties for highlights

string

summarystringnullable

Brief summary of the person.

400Validation error

application/json

statusstring · enumrequired

Values: "error"

errorstringrequired

Human-readable error message describing what went wrong.

401Authentication failed — invalid or missing API key

application/json

statusstring · enumrequired

Values: "error"

errorstringrequired

Human-readable error message describing what went wrong.

501The configured research data source does not support this endpoint or data shape.

application/json

statusstring · enumrequired

Values: "error"

errorstringrequired

Human-readable error message describing what went wrong.

501 example
{
  "status": "error",
  "error": "Request failed with status 501"
}

Full specification

Download the OpenAPI file for complete schemas, constraints, and examples.

Download research.json
View operation source
json
{
  "description": "Search for people in the music industry — artists, managers, A&R reps, producers. Returns multi-source profiles including LinkedIn data.",
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/ResearchPeopleRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "People search results",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ResearchPeopleResponse"
          }
        }
      }
    },
    "400": {
      "description": "Validation error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ResearchErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "Authentication failed — invalid or missing API key",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ResearchErrorResponse"
          }
        }
      }
    },
    "501": {
      "$ref": "#/components/responses/ResearchDataSourceUnsupported"
    }
  }
}