İçeriğe geç

Gönderi Arama

GET/v1/linkedin/search/posts1 kredi

Bir sorguyla eşleşen LinkedIn gönderilerini web üzerinde arar ve her sonucu `/v1/linkedin/post` endpoint'indeki akış gönderisiyle aynı yapıda döndürür.

01Sorgu parametreleri

AdTürAçıklama
queryzorunlustringArama metni, örneğin `ai agents`.
date_postedisteğe bağlıstringSonuçları bu zaman aralığındaki gönderilerle sınırlar.Kabul edilen değerler:last-hourlast-daylast-weeklast-monthlast-year
cursoristeğe bağlıstringGetirilecek sayfa numarası, en fazla 11: önceki yanıtın `cursor` değerini gönderin.Varsayılan: 1

02İstek

curl "https://api.scrapesocial.ai/v1/linkedin/search/posts?query=ai+agents" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

GET /v1/linkedin/search/posts?query=ai%20agents

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "query": "ai agents",
  "posts": [
    {
      "activityUrn": "urn:li:activity:7315357847985233920",
      "contentUrn": "urn:li:ugcPost:7314969666689409024",
      "url": "https://www.linkedin.com/posts/jsu05_ai-agents-for-dummies-activity-7315357847985233920-OdO1",
      "datePublished": "2025-04-08T13:00:23.706Z",
      "description": "What are AI agents?\n\n(for dummies)\n\nAs someone with 0 technical background, I've found the best way to understand AI Agents is to build on concepts I already grasp.\n\nLevel 1️⃣ - Large Language Models\n\nLarge Language Models (LLMs) like ChatGPT are passive systems that generate outputs based on inputs but can't access external information or take autonomous actions.\n\nNote: Technically, ChatGPT is an…",
      "media": "https://media.licdn.com/dms/image/v2/D561FAQEFe0kvOtJSyw/feedshare-document-images_1920/B56ZYP94OXHoAU-/1/1744024617941?e=1793836800&v=beta&t=FHM5hKRs6aM9a6g67t6JTQOwC1vIY2hfcMUq1TAr9OQ",
      "images": [
        "https://media.licdn.com/dms/image/v2/D561FAQEFe0kvOtJSyw/feedshare-document-images_1920/B56ZYP94OXHoAU-/1/1744024617941?e=1793836800&v=beta&t=FHM5hKRs6aM9a6g67t6JTQOwC1vIY2hfcMUq1TAr9OQ",
        "https://media.licdn.com/dms/image/v2/D561FAQEFe0kvOtJSyw/feedshare-document-images_1920/B56ZYP94OXHoAU-/2/1744024617941?e=1793836800&v=beta&t=07z7Jg9ro-yGzLinMMIKQ-81O-x63jV9_MtlHucW0cU"
      ],
      "image": "https://media.licdn.com/dms/image/v2/D561FAQEFe0kvOtJSyw/feedshare-document-images_1920/B56ZYP94OXHoAU-/1/1744024617941?e=1793836800&v=beta&t=FHM5hKRs6aM9a6g67t6JTQOwC1vIY2hfcMUq1TAr9OQ",
      "author": {
        "name": "Jeff Su",
        "url": "https://www.linkedin.com/in/jsu05",
        "image": "https://media.licdn.com/dms/image/v2/D5603AQEmYEH2_P8UzA/profile-displayphoto-shrink_200_200/profile-displayphoto-shrink_200_200/0/1711179090909?e=2147483647&v=beta&t=B1VHTnZSDoHv_R2q3nJ4nnVY9MNmH1Rf6cDd0axO3jU",
        "followers": 99769
      },
      "comments": [
        {
          "author": "Varun Negandhi",
          "text": "This post helps clarify the different levels, Jeff. For my gaming brain, it helps me understand that LLMs are NPCs (non-playable characters) that only respond when you press a button. AI agents are like friends you play multiplayer with, where they read and play the game to achieve a specific objective. ",
          "linkedinUrl": "https://www.linkedin.com/in/vnegandhi"
        },
        {
          "author": "Dean Moon",
          "text": "Now on to the 1M followers on LinkedIn.",
          "linkedinUrl": "https://au.linkedin.com/in/deanjmoon"
        }
      ],
      "likeCount": 642,
      "commentCount": 96
    },
    {
      "activityUrn": "urn:li:activity:7345117017508659200",
      "contentUrn": "urn:li:share:7345117016170659840",
      "url": "https://www.linkedin.com/posts/alexxubyte_systemdesign-coding-interviewtips-activity-7345117017508659200-1dyv",
      "datePublished": "2025-06-29T15:52:42.621Z",
      "description": "What is an AI Agent?\n\nAn AI agent is a software program that can interact with its environment, gather data, and use that data to achieve predetermined goals. AI agents can choose the best actions to perform to meet those goals.\n\nKey characteristics of AI agents are as follows:\n\nAn agent can perform autonomous actions without constant human intervention. Also, they can have a human in the loop to …",
      "media": "https://media.licdn.com/dms/image/v2/D4E22AQGM0sDVYAT_ag/feedshare-shrink_800/B4EZe8Y9d9HIAg-/0/1751212357466?e=2147483647&v=beta&t=F85oOnNrdXB8XkKD1u4FNYxraq85iLV3FCbstQ20UAQ",
      "images": [
        "https://media.licdn.com/dms/image/v2/D4E22AQGM0sDVYAT_ag/feedshare-shrink_800/B4EZe8Y9d9HIAg-/0/1751212357466?e=2147483647&v=beta&t=F85oOnNrdXB8XkKD1u4FNYxraq85iLV3FCbstQ20UAQ"
      ],
      "image": "https://media.licdn.com/dms/image/v2/D4E22AQGM0sDVYAT_ag/feedshare-shrink_800/B4EZe8Y9d9HIAg-/0/1751212357466?e=2147483647&v=beta&t=F85oOnNrdXB8XkKD1u4FNYxraq85iLV3FCbstQ20UAQ",
      "author": {
        "name": "Alex Xu",
        "url": "https://www.linkedin.com/in/alexxubyte",
        "followers": 1038321
      },
      "comments": [
        {
          "author": "Delisa Ondo Kéloufaï",
          "text": "Conversational AI is impressive. But AI agents are game changers. They're not just programs that respond, they're entities that decide, learn, adapt and cooperate. We're moving from a passive tool to an autonomous strategic player, capable of taking initiatives, memorizing our preferences, reasoning in context and working in teams with other agents. For companies (the SMEs I support), the real iss…",
          "linkedinUrl": "https://ca.linkedin.com/in/delisa-ondo-keloufai-marketing-inspire-btob/en"
        },
        {
          "author": "A Mike",
          "text": "Alex Xu This is a great breakdown of AI agents—thanks for sharing. What stands out to me is how the evolution from passive AI models to autonomous agents represents a significant shift in how we think about human-machine collaboration. The ability of AI agents to not only perceive and act but also reason, personalise, and collaborate opens up powerful new use cases—from dynamic supply chain orches…",
          "linkedinUrl": "https://uk.linkedin.com/in/a-mike-380254213"
        }
      ],
      "likeCount": 3526,
      "commentCount": 128
    }
  ],
  "cursor": "2"
}

Tüm uç noktalarda ortak

Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notlar

Yanıtta `query`, `posts` (sayfa başına en fazla 10) ve `cursor` bulunur; `cursor` bir sonraki sayfa numarasıdır (string). Sonuçlar web aramasından gelir, bu yüzden arama motorlarının neyi dizinlediğine bağlıdır. Sonuç yoksa 0 kredi karşılığında `posts: []` döner. 11'den büyük bir cursor veya tanınmayan bir `date_posted` ücretsiz bir 400 döndürür. Web arama motorları hiçbir şey eşleşmediğinde de gevşek ilgili sayfalar döndürür; bu yüzden yalnızca başlığında, özetinde veya URL'sinde sorgunun kelimelerini geçiren sonuçlar tutulur: hiçbir şeyle eşleşmeyen bir sorgu 0 krediyle boş liste döndürür.

05Hatalar ve krediler

Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.

  • 400missing_parameter

    Zorunlu bir parametre eksik veya geçersiz.

  • 403private_account

    Hesap gizli ya da yaş kısıtlamalı.

  • 404not_found

    Böyle bir hesap yok.

  • 503upstream_error

    Platform şu an cevap vermiyor; tekrar deneyin.