Key Concepts

Requests

The Sayari API utilizes standard HTTP verbs:

  • GET for retrieving resources (parameters in URL query string)
  • POST for requesting resources (JSON-encoded request bodies)

See the API reference for details per endpoint.

Example GET request

$curl --request GET \
>     --url 'https://api.sayari.com/v1/resolution?name=VICTORIA%20BECKHAM&country=GBR&type=person' \
>     --header 'accept: application/json' \
>     --header 'authorization: Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc'

Example POST request

$curl --request POST \
>     --url https://api.sayari.com/v1/search/entity \
>     --header 'accept: application/json' \
>     --header 'authorization: Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc' \
>     --header 'content-type: application/json' \
>     --data '
${
$  "filter": {
$    "country": [
$      "GBR"
$    ],
$    "entity_type": [
$      "person"
$    ]
$  },
$  "q": "Victoria Beckham",
$  "fields": [
$    "name"
$  ]
$}
$'