Import content - TalkToHumans

POST

https://api.talktohumans.app

/

v1

/

content

/

import

Import content

curl --request POST \
  --url https://api.talktohumans.app/v1/content/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_id": "42",
  "linkedin_urls": [
    "https://www.linkedin.com/feed/update/urn:li:activity:7254000000000000000/"
  ]
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    account_id: '42',
    linkedin_urls: ['https://www.linkedin.com/feed/update/urn:li:activity:7254000000000000000/']
  })
};

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

import requests

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

payload = {
    "account_id": "42",
    "linkedin_urls": ["https://www.linkedin.com/feed/update/urn:li:activity:7254000000000000000/"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"account_id\": \"42\",\n  \"linkedin_urls\": [\n    \"https://www.linkedin.com/feed/update/urn:li:activity:7254000000000000000/\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

{
  "data": {
    "results": [
      {
        "linkedin_url": "https://www.linkedin.com/feed/update/urn:li:activity:7254000000000000000/",
        "status": "imported",
        "content_id": "cnt_0f8fad5bd9cb469fa16570867728950e",
        "charged_credits": 1
      }
    ],
    "charged_credits": 1
  }
}

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).

Body

application/json

account_id

string

required

LinkedIn account ID returned by GET /v1/accounts.

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

linkedin_urls

string[]

required

LinkedIn post URLs, such as linkedin.com/posts/... or linkedin.com/feed/update/urn:li:activity:..., and lnkd.in links to them. Duplicates are imported once.

Required array length: 1 - 10 elements

Response

One result per unique URL, in request order. Each post costs 1 credit, nothing when the organization imported it within the hour.

data

object

required

Show child attributes

Import content

curl --request POST \
  --url https://api.talktohumans.app/v1/content/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_id": "42",
  "linkedin_urls": [
    "https://www.linkedin.com/feed/update/urn:li:activity:7254000000000000000/"
  ]
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    account_id: '42',
    linkedin_urls: ['https://www.linkedin.com/feed/update/urn:li:activity:7254000000000000000/']
  })
};

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

import requests

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

payload = {
    "account_id": "42",
    "linkedin_urls": ["https://www.linkedin.com/feed/update/urn:li:activity:7254000000000000000/"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"account_id\": \"42\",\n  \"linkedin_urls\": [\n    \"https://www.linkedin.com/feed/update/urn:li:activity:7254000000000000000/\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

{
  "data": {
    "results": [
      {
        "linkedin_url": "https://www.linkedin.com/feed/update/urn:li:activity:7254000000000000000/",
        "status": "imported",
        "content_id": "cnt_0f8fad5bd9cb469fa16570867728950e",
        "charged_credits": 1
      }
    ],
    "charged_credits": 1
  }
}