Skip to content

Social search API for six platforms

Send a platform and a keyword. Get back up to 20 public results from Instagram, TikTok, YouTube, Threads, Pinterest or Reddit, each with its author, text or title, URL and engagement. 5 credits per search.

5 credits / searchSocialMCPNew
POST/v1/social-search
{
  "success": true,
  "data": {
    "platform": "tiktok",
    "query": "specialty coffee",
    "results": [
      {
        "author": "northwindcoffee",
        "text": "Three pour-over mistakes we see every week at the bar",
        "url": "https://www.tiktok.com/@northwindcoffee/video/7300000000000000000",
        "engagement": {
          "likes": 18400,
          "comments": 312,
          "views": 264000
        }
      },
      {
        "author": "contosoroasters",
        "text": "Roasting a 5 kg batch from green to cooled, start to finish",
        "url": "https://www.tiktok.com/@contosoroasters/video/7300000000000000001",
        "engagement": {
          "likes": 9200,
          "comments": 148,
          "views": 131000
        }
      },
      {
        "author": "fabrikamcafe",
        "text": "What specialty coffee means and why the label matters",
        "url": "https://www.tiktok.com/@fabrikamcafe/video/7300000000000000002",
        "engagement": {
          "likes": 4100,
          "comments": 87,
          "views": 58300
        }
      }
    ]
  },
  "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.

platformPlatformThe platform that was searched.
results[].authorAuthorThe handle or username behind the result.
results[].textText or titleThe caption of the post, or its title on platforms that use titles.
results[].urlURLA direct link to the post, video, pin or thread.
results[].engagement.likesLikesLike count the platform shows for the result.
results[].engagement.commentsCommentsComment count for the result.
results[].engagement.viewsViewsView count, on platforms that publish one.
[02/Capabilities]

What Social Search does

01

Six platforms behind one endpoint

Set platform to instagram, tiktok, youtube, threads, pinterest or reddit and pass a keyword. You get the same result shape back from each one, so a single integration covers all six.

02

Up to 20 results per call

Each search returns up to 20 public results. Every result names its author and carries the caption, or the title on platforms that use titles.

03

Engagement on every result

Results include the engagement counts the platform shows publicly, such as likes, comments and views. Sort on them to separate the posts people responded to from the ones nobody saw.

04

URLs that feed the next lookup

Every result has a direct URL. Pass it to Social Post Lookup for the full post record, or to Video Transcript to read what was said in a video.

[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-search5 credits / search

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-search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"tiktok","query":"specialty coffee"}'
Endpoint
POST /v1/social-search
Base URL
https://api.1lookup.dev
Request
platformquery
Price
5 credits / search
Coverage
Instagram, TikTok, YouTube, Threads, Pinterest and Reddit
Bulk
Single requests
Cache
Repeats within 7 days are free
Also via
Dashboard and MCP server (run_lookup)
[05/Use cases]

What teams use it for

Find creators in a niche

Search the terms your customers use, collect the authors who keep appearing, and run those handles through Social Profile Check for follower counts and engagement rate.

Listen for a brand or product name

Search your brand name on Reddit, TikTok and Threads on a schedule and review what comes back. You see public mentions without opening each platform.

Research content before you make it

Look at what already exists for a topic and which results earned engagement. It is a quick read on the formats and angles an audience responds to.

Source customer content

Search for your product name to find posts and videos customers made about it, then contact the authors about permission to reuse them.

Search results are public content, and you are responsible for making sure your use of them follows each platform's terms and applicable privacy law.

[06/Cost]

5 credits / search

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 searchs
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 Search questions

Which platforms can I search?

Instagram, TikTok, YouTube, Threads, Pinterest and Reddit. For X, use X Post Search. Each call searches one platform, so covering all six for one keyword takes six searches.

How much does a search cost?

5 credits per search, whatever number of results comes back, up to 20. A search that fails on our side is not charged.

Can I get more than 20 results?

One call returns up to 20 results for one keyword on one platform. To cover more ground, run related keywords or additional platforms, each as its own search.

Are the results the same as what I see when I search the platform myself?

They come from each platform's public search as seen without an account, so they are not shaped by a follow list or watch history. What you see when logged in to your own account can differ.

Is there a bulk upload for searches?

No. CSV upload is not offered for this product because each search returns a list instead of a single row. Call the API once per keyword. The default rate limit is 50 requests per second per key.

[ Validate ][ Enrich ]
[Get started]

Run Social Search on your own data

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

[ Screen ][ Scrape ]