Endpoint · Profiles

List a profile's articles

Articles where the person is quoted or discussed, with the annotated statements. Newest first.

GET/v1/profiles/{profileReference}/articles

Authentication

Bearer token in the Authorization header. The token reaches what your plan covers. Getting a token.

Parameters

path parameters

profileReferenceuuid·pathrequired
The person's reference.

query parameters

typestring·query
Only annotations of this type, and only articles that have one.speechfeedbackrecommendationreview
rolestring·query
about: the person is the subject. by: the person is the speaker.aboutby
collapsestring·query
latest folds repeated yearly statements from the same organisation, type and speaker into the newest, with history_count. none returns every one.Default latestlatestnone
pageinteger·query
1-based page number.Default 1
limitinteger·query
Rows per page, up to 100. A larger value is capped at 100, not rejected.Default 20

Response

success holds an array of the objects below, and meta holds the paging details.

  • articleobject{ reference, title, url, published_at }.
  • eventsarray{ reference, type, summary } for linked events.
  • aboutarrayAnnotations where the person is the subject.Show 8 fields
    • referenceuuidThe annotation's reference.
    • typestringspeech, feedback, recommendation or review. See statements.
    • summarystringA one-line summary.
    • textstring | nullThe verbatim passage, where the article's licence allows it.
    • startintegerStart offset into the article content, in UTF-16 code units.
    • endintegerEnd offset, in UTF-16 code units.
    • speakerobject{ kind, name, role, organisation_name, profile_reference }. kind is person or body.
    • subjectobject{ name, role, organisation_name, profile_reference }.
  • byarrayAnnotations where the person is the speaker.Show 8 fields
    • referenceuuidThe annotation's reference.
    • typestringspeech, feedback, recommendation or review. See statements.
    • summarystringA one-line summary.
    • textstring | nullThe verbatim passage, where the article's licence allows it.
    • startintegerStart offset into the article content, in UTF-16 code units.
    • endintegerEnd offset, in UTF-16 code units.
    • speakerobject{ kind, name, role, organisation_name, profile_reference }. kind is person or body.
    • subjectobject{ name, role, organisation_name, profile_reference }.

An invalid type, role or collapse returns 422.

Examples

Set CHIKARA_API_TOKEN and each sample runs as written. List samples page until a short page, with a hard cap. Example records are invented.

curl -sS -G "https://api.chikaraintel.com/v1/profiles/a1b2c3d4-e5f6-4a7b-9c8d-e9f0a1b2c341/articles" \
  -H "Authorization: Bearer $CHIKARA_API_TOKEN" \
  -H "Accept: application/json" \
  --data-urlencode "role=about" \
  --data-urlencode "limit=20" \
  --data-urlencode "page=1"

See pagination and errors.

Used by

MCP tools built on this endpoint.

Related