Amygdala EU

Entities

Endpointhttps://api.amygdala.eu

Search for entities

GET

https://api.amygdala.eu

/api/v1/entities/

Search for entities › query Parameters

query

string · required

Search query

alpha_2

string · enum

Alpha-2 country code

Enum values:

limit

integer · min: 5 · max: 1000

Limit

Search for entities › Headers

Authorization

Bearer <api_key> · required

Bearer <api_key>

Search for entities › Responses

object[] · required

duration

number · double

Default: 0

object

request_id

string

GET/api/v1/entities/

curl --request GET \
  --url 'https://api.amygdala.eu/api/v1/entities/?query=%3Cstring%3E' \
  --header 'Authorization: <value>'

shell

Example Responses

{
  "duration": 0.123,
  "cost": {
    "unit": "entity_search",
    "count": 1
  },
  "request_id": "123e4567-e89b-12d3-a456-426614174000",
  "results": [
    {
      "sdu": "294152247252684609194428744833146550207",
      "name": "Lewis Hamilton",
      "pic": "https://pbs.twimg.com/profile_images/1874472051517296640/anm3Q000_normal.jpg",
      "rank": 1,
      "country_name": "United Kingdom",
      "topic": "Formula 1"
    },
    {
      "sdu": "310920314388429788970855127831760636182",
      "name": "Formula 1",
      "pic": "https://pbs.twimg.com/profile_images/1612433922733887489/7f5XFklA_normal.jpg",
      "rank": 2,
      "country_name": "United Kingdom",
      "topic": "Formula 1"
    },
    {
      "sdu": "88640502273534443173088476745876762106",
      "name": "Fernando Alonso",
      "pic": "https://pbs.twimg.com/profile_images/1894450651058356224/HlKYFuSm_normal.jpg",
      "rank": 3,
      "country_name": "Spain",
      "topic": "Formula 1"
    },
    {
      "sdu": "71300195771380492381684629107406813474",
      "name": "Scuderia Ferrari HP",
      "pic": "https://pbs.twimg.com/profile_images/947659786555940865/P5eYYYIx_normal.jpg",
      "rank": 4,
      "country_name": "Italy",
      "topic": "Motorsports"
    },
    {
      "sdu": "16724552394669931343874914053947544429",
      "name": "McLaren Mastercard Formula 1 Team 🧡",
      "pic": "https://pbs.twimg.com/profile_images/2009686309229441024/YAoyori-_normal.jpg",
      "rank": 5,
      "country_name": "United Kingdom",
      "topic": "Mclaren"
    }
  ]
}

json

Retrieving a list of entities with query="Formula 1" and limit=5.

application/json

Retrieve detailed entity

GET

https://api.amygdala.eu

/api/v1/entities/{sdus}/

Retrieve detailed entity › path Parameters

sdus

string · required

Retrieve detailed entity › Headers

Authorization

Bearer <api_key> · required

Bearer <api_key>

Retrieve detailed entity › Responses

object[] · required

duration

number · double

Default: 0

object

request_id

string

GET/api/v1/entities/{sdus}/

curl --request GET \
  --url https://api.amygdala.eu/api/v1/entities/:sdus/ \
  --header 'Authorization: <value>'

shell

Example Responses

{
  "duration": 0.456,
  "cost": {
    "unit": "entity_detail",
    "count": 1
  },
  "request_id": "123e4567-e89b-12d3-a456-426614174000",
  "results": [
    {
      "sdu": "294152247252684609194428744833146550207",
      "name": "Lewis Hamilton",
      "bio": "Lewis Hamilton British Formula One driver for Scuderia Ferrari is a seventime World Champion and record holder for wins pole positions and podiums Known for speed flair and activism he cofounded Mission 44 to combat social injustice and promote STEM education",
      "country": "United Kingdom",
      "topics": [
        "Formula 1",
        "Motorsports"
      ],
      "socials": {
        "x": {
          "handle": "@LewisHamilton",
          "followers": 8608690
        },
        "facebook": {
          "handle": "LewisHamilton",
          "followers": 6400000
        },
        "instagram": {
          "handle": "lewishamilton",
          "followers": 41200000
        },
        "linkedin": {
          "handle": "in/sirlewishamilton",
          "followers": null
        },
        "reddit": {
          "handle": null,
          "followers": 0
        },
        "tiktok": {
          "handle": "@lewishamilton",
          "followers": 2300000
        },
        "snapchat": {
          "handle": null,
          "followers": null
        },
        "youtube": {
          "handle": "@lewishamilton",
          "followers": 222000
        },
        "discord": {
          "handle": null,
          "followers": null
        },
        "twitch": {
          "handle": null,
          "followers": null
        },
        "spotify": {
          "handle": null,
          "followers": null
        },
        "pinterest": {
          "handle": null,
          "followers": null
        }
      },
      "site": "https://www.lewishamilton.com/"
    }
  ]
}

json

Retrieving detailed information for entity with uuid=294152247252684609194428744833146550207.

application/json

Match entities by X handles

GET

https://api.amygdala.eu

/api/v1/match/

Match entities by X handles › query Parameters

x_handle

string · required

X/Twitter handle (e.g. @user). Pass multiple for multiple handles.

Match entities by X handles › Headers

Authorization

string · required

Bearer <api_key>

Match entities by X handles › Responses

object[] · required

duration

number · double

Default: 0

object

request_id

string

GET/api/v1/match/

curl --request GET \
  --url 'https://api.amygdala.eu/api/v1/match/?x_handle=%3Cstring%3E' \
  --header 'Authorization: <string>'

shell

Example Responses

No example specified for this content type

application/json

Get peers by X handles

GET

https://api.amygdala.eu

/api/v1/peers/

Get peers by X handles › query Parameters

x_handle

string · required

X/Twitter handle (e.g. @user). Pass multiple for multiple handles.

Get peers by X handles › Headers

Authorization

string · required

Bearer <api_key>

Get peers by X handles › Responses

object[] · required

duration

number · double

Default: 0

object

request_id

string

GET/api/v1/peers/

curl --request GET \
  --url 'https://api.amygdala.eu/api/v1/peers/?x_handle=%3Cstring%3E' \
  --header 'Authorization: <string>'

shell

Example Responses

No example specified for this content type

application/json

Search for entities

GET

https://api.amygdala.eu

/api/v1/entities/

Search for entities › query Parameters

query

string · required

Search query

alpha_2

string · enum

Alpha-2 country code

Enum values:

limit

integer · min: 5 · max: 1000

Limit

Search for entities › Headers

Authorization

Bearer <api_key> · required

Bearer <api_key>

Search for entities › Responses

object[] · required

duration

number · double

Default: 0

object

request_id

string

{ "duration": 0.123, "cost": { "unit": "entity_search", "count": 1 }, "request_id": "123e4567-e89b-12d3-a456-426614174000", "results": [ { "sdu": "294152247252684609194428744833146550207", "name": "Lewis Hamilton", "pic": "https://pbs.twimg.com/profile_images/1874472051517296640/anm3Q000_normal.jpg", "rank": 1, "country_name": "United Kingdom", "topic": "Formula 1" }, { "sdu": "310920314388429788970855127831760636182", "name": "Formula 1", "pic": "https://pbs.twimg.com/profile_images/1612433922733887489/7f5XFklA_normal.jpg", "rank": 2, "country_name": "United Kingdom", "topic": "Formula 1" }, { "sdu": "88640502273534443173088476745876762106", "name": "Fernando Alonso", "pic": "https://pbs.twimg.com/profile_images/1894450651058356224/HlKYFuSm_normal.jpg", "rank": 3, "country_name": "Spain", "topic": "Formula 1" }, { "sdu": "71300195771380492381684629107406813474", "name": "Scuderia Ferrari HP", "pic": "https://pbs.twimg.com/profile_images/947659786555940865/P5eYYYIx_normal.jpg", "rank": 4, "country_name": "Italy", "topic": "Motorsports" }, { "sdu": "16724552394669931343874914053947544429", "name": "McLaren Mastercard Formula 1 Team 🧡", "pic": "https://pbs.twimg.com/profile_images/2009686309229441024/YAoyori-_normal.jpg", "rank": 5, "country_name": "United Kingdom", "topic": "Mclaren" } ] }

Retrieve detailed entity

GET

https://api.amygdala.eu

/api/v1/entities/{sdus}/

Retrieve detailed entity › path Parameters

sdus

string · required

Retrieve detailed entity › Headers

Authorization

Bearer <api_key> · required

Bearer <api_key>

Retrieve detailed entity › Responses

object[] · required

duration

number · double

Default: 0

object

request_id

string

{ "duration": 0.456, "cost": { "unit": "entity_detail", "count": 1 }, "request_id": "123e4567-e89b-12d3-a456-426614174000", "results": [ { "sdu": "294152247252684609194428744833146550207", "name": "Lewis Hamilton", "bio": "Lewis Hamilton British Formula One driver for Scuderia Ferrari is a seventime World Champion and record holder for wins pole positions and podiums Known for speed flair and activism he cofounded Mission 44 to combat social injustice and promote STEM education", "country": "United Kingdom", "topics": [ "Formula 1", "Motorsports" ], "socials": { "x": { "handle": "@LewisHamilton", "followers": 8608690 }, "facebook": { "handle": "LewisHamilton", "followers": 6400000 }, "instagram": { "handle": "lewishamilton", "followers": 41200000 }, "linkedin": { "handle": "in/sirlewishamilton", "followers": null }, "reddit": { "handle": null, "followers": 0 }, "tiktok": { "handle": "@lewishamilton", "followers": 2300000 }, "snapchat": { "handle": null, "followers": null }, "youtube": { "handle": "@lewishamilton", "followers": 222000 }, "discord": { "handle": null, "followers": null }, "twitch": { "handle": null, "followers": null }, "spotify": { "handle": null, "followers": null }, "pinterest": { "handle": null, "followers": null } }, "site": "https://www.lewishamilton.com/" } ] }

Match entities by X handles

GET

https://api.amygdala.eu

/api/v1/match/

Match entities by X handles › query Parameters

x_handle

string · required

X/Twitter handle (e.g. @user). Pass multiple for multiple handles.

Match entities by X handles › Headers

Authorization

string · required

Bearer <api_key>

Match entities by X handles › Responses

object[] · required

duration

number · double

Default: 0

object

request_id

string

Get peers by X handles

GET

https://api.amygdala.eu

/api/v1/peers/

Get peers by X handles › query Parameters

x_handle

string · required

X/Twitter handle (e.g. @user). Pass multiple for multiple handles.

Get peers by X handles › Headers

Authorization

string · required

Bearer <api_key>

Get peers by X handles › Responses

object[] · required

duration

number · double

Default: 0

object

request_id

string