Skip to navigation

Match links from your own data to posts

Requires posts:read. Resolve up to 100 post links — from a campaign tracker, a creator list, or a post-performance report — to posts on this team. Each input comes back once, in input order, with a status:

  • matched: on the team and processed (post has the join keys and stored scores)
  • processing: on the team, still syncing or scoring
  • failed: on the team, processing failed
  • not_in_workspace: a supported link the team has not added (or has archived)
  • invalid_url / unsupported_platform: not a post link Siftsy analyzes

Query strings (tracking parameters), www., http vs https, and trailing slashes are ignored. Short links (vm.tiktok.com, youtu.be) match only if that exact short link was added; send the full post URL when you have it. meta.matchedPostIds feeds straight into selection.postIds for POST /posts/scan, POST /breakdowns, or POST /analyses. Nothing is added or charged; to add missing links use POST /content/posts/add.

Rate class posts_match (20 / minute, 500 / day per key).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

OR
X-Api-Keystring
API Key authentication via header

Request

This endpoint expects an object.

Response

One row per input link
datalist of objectsOptional
metaobjectOptional

Errors

400
Bad Request Error
403
Forbidden Error
429
Too Many Requests Error