Authentication

All Diffbot API requests (GET and POST) are authenticated via the token parameter with a token created upon registration of a new Diffbot account or generated under parent tokens.

How to get a Diffbot API token

You may register for a trial token here.

Once registered, to access your token, go to the Diffbot Dashboard home screen and click the link in the top right hand corner.

Your token details page will reveal your full token along with usage activity and invoice history.

How to authenticate Diffbot API requests

Supply your Diffbot API token to the token parameter of any request. See examples below for GET and POST requests.

curl --request GET \
     --url 'https://api.diffbot.com/v3/analyze?token=YOURDIFFBOTTOKEN&url=https%3A%2F%2Fdocs.diffbot.com' \
     --header 'accept: application/json'

curl --request POST \
     --url 'https://kg.diffbot.com/kg/v3/enhance?token=YOURDIFFBOTTOKEN' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "name": "Diffbot",
  "type": "Organization"
}
'