Connectors › Harvest API

Harvest API recent posts

Enrich a person with the text of their recent LinkedIn posts via HarvestAPI, at most posts_limit, for a compose step to read.

Connectorharvest/recent-posts
Roleenrich
Recordsperson
Tierverified since 2026-09-27
CredentialHARVEST_API_KEY stored once with gtme secret set HARVEST_API_KEY
Costunset in the manifest; gtme plan prints what the step declares at run time
Cache30 days: a re-run inside the window reads the ledger instead of paying again
CallsGET https://api.harvestapi.io/linkedin/profile-posts
Sourcegithub.com/gtme-run/gtme-bindings/harvest-recent-posts

Use it

Install it from the registry. Nothing installs unverified: the fixtures run offline first.

gtme adapters add github.com/gtme-run/gtme-bindings/harvest-recent-posts@main

The command prints the hosts the binding will call and the credentials it will ask for, then pins the commit it fetched. Then, in a pipeline file:

steps:
  - id: recent-posts
    use: harvest/recent-posts

gtme plan pipeline.yaml checks the credential is set and that every field this step needs is provided by a step before it, without calling anyone.

Needs

linkedin_url

Provides

recent_posts

Config

KeyTypeWhat it does
posts_limitintegerThe most posts to keep, newest first Default 3.
cost_per_call_usdnumberWhat one posts call costs on your HarvestAPI plan Default 0.012.
base_urlstringOverride the API host (testing) Default https://api.harvestapi.io.

What a response looks like

Recorded from a real response to GET /linkedin/profile-posts, status 200. The conformance kit proves this payload in produces canonical records out, and gtme run --simulate serves it in place of the network.

{
  "elements": [
    {
      "content": "We cut our CAC in half by killing three channels. Here is what we kept.",
      "postedAt": "2026-07-02"
    },
    {
      "text": "Hiring two lifecycle marketers. DMs open.",
      "postedAt": "2026-06-20"
    },
    {
      "content": "",
      "postedAt": "2026-06-01"
    },
    {
      "content": "A fourth post that should not appear when the limit is three.",
      "postedAt": "2026-05-11"
    }
  ],
  "status": "ok"
}

On this page, connector means what gtme calls an adapter. This one is a binding from the registry. Two adapter tiers explains the difference.