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"
>  ]
>}
>'