Feeds

One-off queries

GET /v1/query returns the latest posts of an account once, without creating a tracker. Use it to preview an account or for occasional lookups.

curl "https://usefeeds.com/v1/query?source=twitter&handle=nasa&limit=10" \
  -H "Authorization: Bearer $FEEDS_API_KEY"
Parameter Notes
source twitter or linkedin
handle Same spellings as for trackers
limit 1 to 50, default 20

The response has items (same shape as tracker items), cached, and credits, the credits this query was charged.

Cost

A query is charged only when it succeeds: on X, 1 credit plus 1 per post returned; on LinkedIn, a flat 80 credits. Your balance must cover the query at its limit before it runs. Identical queries within 15 minutes may be answered from cache and are charged the same.

If you read the same account more than a few times a month, a tracker is cheaper.