People

Search and retrieve additional information on known persons that exist within Perigon's entity database and as referenced in any article response object. Our database contains over 650,000 people from around the world and is refreshed frequently. People data is derived from Wikidata and includes a wikidataId field that can be used to lookup even more information on Wikidata's website.

get/v1/people/all

Query parameters

namestring

String. Search by person's name. Supports Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* and ?) for flexible searching.

wikidataIdstring[]

String Array. Filter by Wikidata entity IDs (e.g., Q7747, Q937). These are unique identifiers from Wikidata.org that precisely identify public figures and eliminate name ambiguity. Multiple values create an OR filter.

occupationIdstring[]

String Array. Filter by Wikidata occupation IDs (e.g., Q82955 for politician, Q33999 for actor, Q19546 for businessman). Finds people with specific professions. Multiple values create an OR filter.

occupationLabelstring

String. Search by occupation name (e.g., politician, actor, CEO, athlete). Supports Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* and ?) for flexible searching.

pageinteger

Integer. The specific page of results to retrieve in the paginated response. Starts at 0.

sizeinteger

Integer. The number of people to return per page in the paginated response.

Response

200 - Success

statusinteger required

numResultsinteger required

Example response

{
  "status": 200,
  "numResults": 773198,
  "results": [
    {
      "wikidataId": "Q317521",
      "updatedAt": "2025-08-06T05:17:13.358689+00:00",
      "name": "Elon Musk",
      "gender": {
        "wikidataId": "Q6581097",
        "label": "male"
      },
      "dateOfBirth": {
        "time": "1971-06-28T00:00:00+00:00",
        "precision": "day"
      },
      "dateOfDeath": null,
      "description": "South African-Canadian-American businessman, engineer, inventor and political figure",
      "aliases": [
        "Elon Reeve Musk"
      ],
      "occupation": [
        {
          "wikidataId": "Q5482740",
          "label": "programmer"
        },
        {
          "wikidataId": "Q81096",
          "label": "engineer"
        },
        {
          "wikidataId": "Q131524",
          "label": "entrepreneur"
        },
        {
          "wikidataId": "Q557880",
          "label": "investor"
        },
        {
          "wikidataId": "Q43845",
          "label": "businessperson"
        },
        {
          "wikidataId": "Q82955",
          "label": "politician"
        },
        {
          "wikidataId": "Q212238",
          "label": "civil servant"
        },
        {
          "wikidataId": "Q133253419",
          "label": "technology entrepreneur"
        },
        {
          "wikidataId": "Q205375",
          "label": "inventor"
        }
      ],
      "position": [
        {
          "wikidataId": "Q484876",
          "label": "chief executive officer",
          "startTime": {
            "time": "2002-01-01T00:00:00+00:00",
            "precision": "year"
          },
          "endTime": null,
          "employer": null
        },
        {
          "wikidataId": "Q140686",
          "label": "chairperson",
          "startTime": {
            "time": "2008-01-01T00:00:00+00:00",
            "precision": "year"
          },
          "endTime": {
            "time": "2018-11-01T00:00:00+00:00",
            "precision": "month"
          },
          "employer": null
        },
        {
          "wikidataId": "Q484876",
          "label": "chief executive officer",
          "startTime": {
            "time": "2008-10-01T00:00:00+00:00",
            "precision": "month"
          },
          "endTime": null,
          "employer": null
        },
        {
          "wikidataId": "Q105490190",
          "label": "co-president",
          "startTime": {
            "time": "2016-07-01T00:00:00+00:00",
            "precision": "month"
          },
          "endTime": null,
          "employer": null
        },
        {
          "wikidataId": "Q484876",
          "label": "chief executive officer",
          "startTime": {
            "time": "2022-10-28T00:00:00+00:00",
            "precision": "day"
          },
          "endTime": {
            "time": "2023-06-05T00:00:00+00:00",
            "precision": "day"
          },
          "employer": null
        },
        {
          "wikidataId": "Q7450652",
          "label": "Senior Advisor to the President of the United States",
          "startTime": {
            "time": "2025-01-20T00:00:00+00:00",
            "precision": "day"
          },
          "endTime": {
            "time": "2025-05-30T00:00:00+00:00",
            "precision": "day"
          },
          "employer": null
        }
      ],
      "politicalParty": [
        {
          "wikidataId": "Q135219011",
          "label": "America Party",
          "startTime": null,
          "endTime": null
        }
      ],
      "image": {
        "url": "https://people-api-assets.s3.amazonaws.com/images/wikidata/Q317521.jpg"
      },
      "abstract": "Elon Reeve Musk is a businessman. He is known for his leadership of Tesla, SpaceX, X, and the Department of Government Efficiency (DOGE). Musk has been considered the wealthiest person in the world since 2021; as of May 2025, Forbes estimates his net worth to be US$424.7 billion."
    }
  ]
}

Changes

Changed in 5 of the 17 revisions of this API.193992

Aug 18, 2025a73a3b58ca6612278See the full diff
- ▲
  the status response's property type/format changed from string/ to integer/int32 for status 429
  response-property-type-changed
- ●
  removed the optional property cause from the response with the 400 status
  response-optional-property-removed
- ●
  removed the optional property cause from the response with the 401 status
  response-optional-property-removed
- ●
  removed the optional property cause from the response with the 403 status
  response-optional-property-removed
- ●
  removed the optional property cause from the response with the 429 status
  response-optional-property-removed
- ●
  removed the optional property cause from the response with the 500 status
  response-optional-property-removed
- ●
  removed the optional property localizedMessage from the response with the 400 status
  response-optional-property-removed
- ●
  removed the optional property localizedMessage from the response with the 401 status
  response-optional-property-removed
- ●
  removed the optional property localizedMessage from the response with the 403 status
  response-optional-property-removed
- ●
  removed the optional property localizedMessage from the response with the 429 status
  response-optional-property-removed
- ●
  removed the optional property localizedMessage from the response with the 500 status
  response-optional-property-removed
- ●
  removed the optional property stackTrace from the response with the 400 status
  response-optional-property-removed
- ●
  removed the optional property stackTrace from the response with the 401 status
  response-optional-property-removed
- ●
  removed the optional property stackTrace from the response with the 403 status
  response-optional-property-removed
- ●
  removed the optional property stackTrace from the response with the 429 status
  response-optional-property-removed
- ●
  removed the optional property stackTrace from the response with the 500 status
  response-optional-property-removed
- ●
  removed the optional property statusCode from the response with the 401 status
  response-optional-property-removed
- ●
  removed the optional property statusCode from the response with the 403 status
  response-optional-property-removed
- ●
  removed the optional property suppressed from the response with the 400 status
  response-optional-property-removed
- ●
  removed the optional property suppressed from the response with the 401 status
  response-optional-property-removed
- ●
  removed the optional property suppressed from the response with the 403 status
  response-optional-property-removed
- ●
  removed the optional property suppressed from the response with the 429 status
  response-optional-property-removed
- ●
  removed the optional property suppressed from the response with the 500 status
  response-optional-property-removed
- ○
  the endpoint scheme security apiKeyAuth was added to the API
  api-security-added
- ○
  added the optional property status to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property status to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property status to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property status to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property timestamp to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property timestamp to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property timestamp to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property timestamp to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property timestamp to the response with the 500 status
  response-optional-property-added
- ○
  removed the 100 CONTINUE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 101 SWITCHING_PROTOCOLS enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 102 PROCESSING enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 103 CHECKPOINT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 200 OK enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 201 CREATED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 202 ACCEPTED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 203 NON_AUTHORITATIVE_INFORMATION enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 204 NO_CONTENT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 205 RESET_CONTENT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 206 PARTIAL_CONTENT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 207 MULTI_STATUS enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 208 ALREADY_REPORTED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 226 IM_USED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 300 MULTIPLE_CHOICES enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 301 MOVED_PERMANENTLY enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 302 FOUND enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 302 MOVED_TEMPORARILY enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 303 SEE_OTHER enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 304 NOT_MODIFIED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 305 USE_PROXY enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 307 TEMPORARY_REDIRECT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 308 PERMANENT_REDIRECT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 400 BAD_REQUEST enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 401 UNAUTHORIZED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 402 PAYMENT_REQUIRED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 403 FORBIDDEN enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 404 NOT_FOUND enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 405 METHOD_NOT_ALLOWED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 406 NOT_ACCEPTABLE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 407 PROXY_AUTHENTICATION_REQUIRED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 408 REQUEST_TIMEOUT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 409 CONFLICT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 410 GONE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 411 LENGTH_REQUIRED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 412 PRECONDITION_FAILED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 413 PAYLOAD_TOO_LARGE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 413 REQUEST_ENTITY_TOO_LARGE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 414 REQUEST_URI_TOO_LONG enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 414 URI_TOO_LONG enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 415 UNSUPPORTED_MEDIA_TYPE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 416 REQUESTED_RANGE_NOT_SATISFIABLE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 417 EXPECTATION_FAILED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 418 I_AM_A_TEAPOT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 419 INSUFFICIENT_SPACE_ON_RESOURCE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 420 METHOD_FAILURE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 421 DESTINATION_LOCKED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 422 UNPROCESSABLE_ENTITY enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 423 LOCKED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 424 FAILED_DEPENDENCY enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 425 TOO_EARLY enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 426 UPGRADE_REQUIRED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 428 PRECONDITION_REQUIRED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 429 TOO_MANY_REQUESTS enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 431 REQUEST_HEADER_FIELDS_TOO_LARGE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 451 UNAVAILABLE_FOR_LEGAL_REASONS enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 500 INTERNAL_SERVER_ERROR enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 501 NOT_IMPLEMENTED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 502 BAD_GATEWAY enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 503 SERVICE_UNAVAILABLE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 504 GATEWAY_TIMEOUT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 505 HTTP_VERSION_NOT_SUPPORTED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 506 VARIANT_ALSO_NEGOTIATES enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 507 INSUFFICIENT_STORAGE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 508 LOOP_DETECTED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 509 BANDWIDTH_LIMIT_EXCEEDED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 510 NOT_EXTENDED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 511 NETWORK_AUTHENTICATION_REQUIRED enum value from the status response property for the response status 429
  response-property-enum-value-removed
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 4, 20253eb8ae4622b818179See the full diff
- ▲
  the response property results/items/dateOfBirth became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/dateOfDeath became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/gender became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/image became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/politicalParty/items/endTime became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/politicalParty/items/startTime became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/position/items/employer became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/position/items/endTime became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/position/items/startTime became nullable for the status 200
  response-property-became-nullable
- ▲
  the results/items/dateOfBirth response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ▲
  the results/items/dateOfDeath response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ▲
  the results/items/gender response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ▲
  the results/items/image response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ▲
  the results/items/politicalParty/items/endTime response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ▲
  the results/items/politicalParty/items/startTime response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ▲
  the results/items/position/items/employer response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ▲
  the results/items/position/items/endTime response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ▲
  the results/items/position/items/startTime response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ●
  removed the optional property results/items/dateOfBirth/precision from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/dateOfBirth/time from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/dateOfDeath/precision from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/dateOfDeath/time from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/gender/label from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/gender/wikidataId from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/image/url from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/politicalParty/items/endTime/precision from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/politicalParty/items/endTime/time from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/politicalParty/items/startTime/precision from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/politicalParty/items/startTime/time from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/position/items/employer/label from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/position/items/employer/wikidataId from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/position/items/endTime/precision from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/position/items/endTime/time from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/position/items/startTime/precision from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/position/items/startTime/time from the response with the 200 status
  response-optional-property-removed
- ○
  added ImageHolder to the results/items/image response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WikidataDateHolder to the results/items/dateOfBirth response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WikidataDateHolder to the results/items/dateOfDeath response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WikidataDateHolder to the results/items/politicalParty/items/endTime response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WikidataDateHolder to the results/items/politicalParty/items/startTime response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WikidataDateHolder to the results/items/position/items/endTime response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WikidataDateHolder to the results/items/position/items/startTime response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WikidataLabelHolder to the results/items/gender response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WikidataLabelHolder to the results/items/position/items/employer response property allOf list for the response status 200
  response-property-all-of-added
Jul 31, 2025556127fafa6a1See the full diff
- ○
  api tag Supplemental Endpoints removed
  api-tag-removed
Jun 4, 202552b02cb255321See the full diff
- ○
  api tag Supplemental Endpoints added
  api-tag-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 8, 2025ae72ecd67fb13See the full diff
- ○
  the response property numResults became required for the status 200
  response-property-became-required
- ○
  the response property results became required for the status 200
  response-property-became-required
- ○
  the response property status became required for the status 200
  response-property-became-required

Full history