List content

GET

https://api.talktohumans.app

content

List content

curl --request GET \
  --url https://api.talktohumans.app/v1/content \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.talktohumans.app/v1/content', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.talktohumans.app/v1/content"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "data": {
    "content": [
      {
        "content_id": "cnt_0f8fad5bd9cb469fa16570867728950e",
        "account": {
          "account_id": "<string>",
          "display_name": "<string>",
          "provider_account_id": "<string>",
          "owner_user_id": "<string>"
        },
        "content_type": "post",
        "author": {
          "provider_participant_id": "<string>",
          "name": "<string>",
          "contact_id": "<string>",
          "headline": "<string>",
          "linkedin_url": "<string>"
        },
        "linkedin_url": "<string>",
        "posted_at": "2023-11-07T05:31:56Z",
        "reaction_count": 123,
        "comment_count": 123,
        "repost_count": 123,
        "media_type": "none",
        "media": {
          "images": [
            {
              "url": "<string>",
              "width": 123,
              "height": 123
            }
          ],
          "title": "<string>",
          "subtitle": "<string>",
          "link_url": "<string>",
          "page_count": 123,
          "document_url": "<string>"
        },
        "source": "mine",
        "tags": [
          {
            "name": "<string>",
            "color": "green"
          }
        ],
        "engagers_view_id": "<string>",
        "engagers_extracted_at": "2023-11-07T05:31:56Z",
        "new_comments_since_extraction": 123,
        "results": {
          "engagers": 123,
          "contacted": 123,
          "connected": 123,
          "replied": 123
        },
        "parent": {
          "linkedin_url": "<string>",
          "author": {
            "provider_participant_id": "<string>",
            "name": "<string>",
            "contact_id": "<string>",
            "headline": "<string>",
            "linkedin_url": "<string>"
          },
          "text": "<string>"
        },
        "text": "<string>"
      }
    ],
    "pagination": {
      "limit": 10,
      "has_more": true,
      "next_cursor": "<string>"
    }
  }
}

Authorizations

Authorization

string

header

required

Pass Authorization: Bearer <credential>, where the credential is either:

an API key (sk_…), generated by an organization admin in Settings, for scripts and automation;
an access token from tth auth login (the TalkToHumans CLI), which any member of the workspace can use.

Both resolve to the same organization and user. A login token acts in the user's workspace: one with no workspace yet returns 403 workspace_setup_required, and one in several workspaces returns 403 forbidden (use an API key instead).

Query Parameters

account_id

string[]

LinkedIn account IDs returned by GET /v1/accounts.

Repeat the query parameter for multiple accounts. The backend also accepts comma-separated values. If an explicit account target is not accessible to this credential, the API returns 403 account_shared_access_required.

Pattern: ^[1-9][0-9]*$

content_id

string

Filter by content ID, to read one post or comment.

contact_id

string

Filter by the author's contact ID, to read a contact's posts and comments found with POST /v1/contacts/{contact_id}/find-content.

Pattern: ^[1-9][0-9]*$

view_id

string

Filter by a saved content view. Accepts the view id or an unambiguous public_id from GET /v1/views. Uses the view's account and filters. An explicit account_id scope must include that account.

filters

string

JSON array of filters content must all match, in the same shape as a content view's filters. Content fields (content.): content_type, media_type, text, author, posted_at, reaction_count, comment_count, repost_count, source, tags. Requires exactly one account: pass one account_id when several are accessible.

sorts

string

JSON array of sorts, first entry first, in the same shape as a content view's sorts. Newest first by default. Requires exactly one account.

limit

integer

default:10

Page size. Defaults to 10. Values above 25 are clamped to 25.

Required range: 1 <= x <= 25

cursor

string

Opaque cursor from the previous response's pagination.next_cursor.

Response

Posts and comments matching the filters.

data

object

required

Show child attributes

List content

curl --request GET \
  --url https://api.talktohumans.app/v1/content \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.talktohumans.app/v1/content', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.talktohumans.app/v1/content"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "data": {
    "content": [
      {
        "content_id": "cnt_0f8fad5bd9cb469fa16570867728950e",
        "account": {
          "account_id": "<string>",
          "display_name": "<string>",
          "provider_account_id": "<string>",
          "owner_user_id": "<string>"
        },
        "content_type": "post",
        "author": {
          "provider_participant_id": "<string>",
          "name": "<string>",
          "contact_id": "<string>",
          "headline": "<string>",
          "linkedin_url": "<string>"
        },
        "linkedin_url": "<string>",
        "posted_at": "2023-11-07T05:31:56Z",
        "reaction_count": 123,
        "comment_count": 123,
        "repost_count": 123,
        "media_type": "none",
        "media": {
          "images": [
            {
              "url": "<string>",
              "width": 123,
              "height": 123
            }
          ],
          "title": "<string>",
          "subtitle": "<string>",
          "link_url": "<string>",
          "page_count": 123,
          "document_url": "<string>"
        },
        "source": "mine",
        "tags": [
          {
            "name": "<string>",
            "color": "green"
          }
        ],
        "engagers_view_id": "<string>",
        "engagers_extracted_at": "2023-11-07T05:31:56Z",
        "new_comments_since_extraction": 123,
        "results": {
          "engagers": 123,
          "contacted": 123,
          "connected": 123,
          "replied": 123
        },
        "parent": {
          "linkedin_url": "<string>",
          "author": {
            "provider_participant_id": "<string>",
            "name": "<string>",
            "contact_id": "<string>",
            "headline": "<string>",
            "linkedin_url": "<string>"
          },
          "text": "<string>"
        },
        "text": "<string>"
      }
    ],
    "pagination": {
      "limit": 10,
      "has_more": true,
      "next_cursor": "<string>"
    }
  }
}

Conversations

Templates

Contacts

Content

Companies

Custom fields

Tags

Enrich

Views

Sequences

Accounts

Activity

Agents

Authorizations

Query Parameters

Response