Skip to content

Social post lookup API for likes, views and captions

Send the URL of a post, video or pin. Get back the caption, author, posted date, media type, hashtags and the public like, comment, share and view counts. 5 credits per lookup.

5 creditsSocialCSV bulkMCPNew
POST/v1/social-post-lookup
{
  "success": true,
  "data": {
    "url": "https://www.tiktok.com/@northwindcoffee/video/7300000000000000000",
    "platform": "tiktok",
    "post_id": "7300000000000000000",
    "media_type": "video",
    "caption": "How we dial in a new Ethiopian single origin before it hits the shelf. #specialtycoffee #roastery",
    "author": {
      "handle": "northwindcoffee",
      "display_name": "Northwind Coffee Roasters"
    },
    "posted_at": "2026-10-28T16:42:00Z",
    "likes": 18400,
    "comments": 312,
    "shares": 947,
    "views": 264000,
    "hashtags": [
      "specialtycoffee",
      "roastery"
    ]
  },
  "meta": {
    "credits_used": 5,
    "credits_remaining": 999,
    "cached": false,
    "request_id": "req_8f3a2c1e9b7d"
  }
}
[01/Response]

What you get back

The fields most teams branch on. The full response is in the sample on this page and in the API reference.

captionCaptionThe full text published with the post.
author.handleAuthorThe handle of the account that published the post.
posted_atPosted dateWhen the post went up, as an ISO 8601 timestamp.
media_typeMedia typeThe kind of post, such as video or image.
likesLikesPublic like count when the lookup ran.
commentsCommentsNumber of comments on the post. The comment text is not included.
sharesSharesHow many times the post was shared, where the platform shows it.
viewsViewsView or play count, where the platform shows it.
[02/Capabilities]

What Social Post Lookup does

01

The platform is read from the URL

There is one input field. Paste a post, video or pin URL from any of the ten supported platforms and the API works out which platform it belongs to and which post it is.

02

Four engagement counts as integers

Likes, comments, shares and views come back as plain numbers, read at the time of the lookup. A count the platform does not show publicly for that post is returned as null.

03

Caption and hashtags as text

You get the full caption as a string and the hashtags parsed into an array. That is enough to classify a post, check for a required disclosure tag or search your own archive later.

04

Author and timestamp on every post

Each result names the account that published the post and when it went up. You can confirm that a URL belongs to the creator who sent it and that it was posted inside your campaign window.

[03/Try it]

See the response before you sign up

Fill in the request and run it. The dashboard has the same form, plus history, bulk upload and live data.

POST /v1/social-post-lookup5 credits

Preview mode: this page returns a sample response so you can see the shape of the data. Create a key to run it on live data.

Response

Fill in the field and run the lookup to see what comes back.

[04/Integrate]

One POST request

Send JSON with a Bearer key. The same key works for all 79 products.

curl -X POST https://api.1lookup.dev/v1/social-post-lookup \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/@northwindcoffee/video/7300000000000000000"}'
Endpoint
POST /v1/social-post-lookup
Base URL
https://api.1lookup.dev
Request
url
Price
5 credits
Coverage
10 platforms
Bulk
CSV upload and bulk API
Cache
Repeats within 7 days are free
Also via
Dashboard and MCP server (run_lookup)
[05/Use cases]

What teams use it for

Report on creator deliverables

Collect the post URLs your creators send, upload them as a CSV and get views and engagement for every deliverable in one file. No screenshots and no logging in to each platform.

Track a post while it is live

Look the same URL up every day with fresh: true and store the counts. You end up with a simple growth curve for a launch post or a paid partnership.

Check a post before you license it

Before you repost or pay for customer content, confirm who published it, when it was posted and how it performed.

Feed captions into analysis

Pull captions and hashtags for a set of competitor posts and pass them to your own classifier or an LLM to see which topics and formats earn engagement.

Post data comes from public pages, and it is your responsibility to use it in a way that respects platform terms and the privacy laws that apply to you.

[06/Cost]

5 credits

Credits come with your plan and work on every product. Requests that fail on our side are never charged. Beyond your plan, extra credits are pay as you go.

See pricing
PlanPer 1,000 creditsPer 1,000 lookups
Starter $29/mo$4.83$24.17
Growth $99/mo$3.96$19.80
Pro $299/mo$3.32$16.61
Scale $799/mo$2.66$13.32
[07/FAQ]

Social Post Lookup questions

What kinds of URLs does it accept?

Public post, video and pin URLs from ten platforms. The platform is detected from the URL, so there is no platform field to set. A URL from a platform we do not support returns an error and is not charged.

How much does a post lookup cost?

5 credits per URL. Posts that were deleted, set to private or cannot be found are not charged, and neither are requests that fail on our side.

How current are the counts?

Counts are read when the lookup runs. The result is then cached for 7 days, so a repeat of the same URL in that window is free and returns the stored numbers. Pass fresh: true to pay for a new reading.

Does it return the comments themselves?

No. You get the comment count, not the comment text. For replies to an X post use X Post Replies, and for the people who reacted to or commented on a LinkedIn post use LinkedIn Post Engagers.

Can I look up many posts in one job?

Yes. Put the URLs in a CSV and upload it in the dashboard, or send them to the bulk API with an idempotency key. The result file keeps your columns and adds the post fields.

[ Validate ][ Enrich ]
[Get started]

Run Social Post Lookup on your own data

Starter is $29 a month for 6,000 credits, enough for 1,200 lookups a month.

[ Screen ][ Scrape ]