Search public B2B posts & executive discussions by keyword
GET/v1/posts/search2 Credits / post (min 10)($0.20 / 1K posts ($0.08 Business))· Updated 2026-11-08
GET /v1/posts/search queries public B2B posts and executive discussions by keyword or phrase to surface real-time buying intent, competitor mentions, and category conversations via REST. Returned items include post_urn, url, text, published_at, author_name, author_username, author_headline, reactions_count, comments_count, reposts_count, and media metadata with limit and offset controls. Pricing is $0.20 per 1,000 returned posts ($0.08/1K on Business; 2 credits/post, 10-credit minimum per non-empty page, 0 credits on empty or error responses). Queries resolve in 15 ms p50 from local PostgreSQL 16 storage (~1.6 s on live upstream fallback) with zero LinkedIn OAuth, cookies, or proxies across 30–300 RPM plans.
When to Use vs. Honest Limitations
- →Recent & high-signal public posts vs. multi-year firehose: Designed for B2B social-listening and intent keywords; combine specific product or pain-point phrases for highest signal-to-noise precision.
- →10-minute search cache window: Identical keyword + pagination requests are cached for 10 minutes (600s); paid accounts may pass ?fresh=1 to force a live upstream search.
- →Chain with /v1/profile for full author enrichment: Each post includes author_username and headline; call GET /v1/profile ($1.00/1K) on qualified authors to append full company and career firmographics.
Monitor B2B buying intent, competitor mentions, and industry discussions across public professional posts.
Query Parameters
querystringrequiredSearch keyword or phrase (
enterprise AI agents,SOC2 compliance,payment orchestration).Example:
enterprise AI agentssort_bystringSort order (
relevanceordate_posted).Example:
relevancepageinteger (1 to 50)Page number (1-indexed).
Example:
1
Example Request (cURL / Python / JavaScript)
curl "https://api.b2bprofileapi.com/v1/posts/search?query=enterprise+AI+agents" \
-H "x-api-key: b2b_live_your_api_key"Live Response Preview
{
"code": 0,
"status": "ok",
"msg": "success",
"provider": "https://b2bprofileapi.com",
"data": {
"items": [
{
"post_id": "7258991122334455667",
"author_type": "person",
"author_slug": "darioamodei",
"author_name": "Dario Amodei",
"author_headline": "CEO and Co-Founder at Anthropic",
"text": "Enterprise adoption of tool-using AI agents requires reliable, deterministic APIs and verifiable guardrails.",
"like_count": 9320,
"comment_count": 614,
"repost_count": 1120,
"media_type": "text",
"post_url": "https://www.linkedin.com/feed/update/urn:li:activity:7258991122334455667",
"posted_at": "2026-11-03T18:40:00Z"
}
]
},
"meta": {
"page": 1,
"limit": 10,
"has_more": true,
"next_page": 2,
"credits_charged": 10
}
}Response Fields
Success (code === 0). Deducts 2 Credits per post returned (min 10 Credits on hit).
| Field | Type | Sample / Notes |
|---|---|---|
code | integer | Application status code (0 = success, non-zero = error). |
status | string | Human-readable status string (ok or error). |
msg | string | Response status message (success). |
provider | string | Canonical API provider URL (https://b2bprofileapi.com). |
data | object | Normalized B2B intelligence payload. |
items | array of object | Array of returned search or feed records. |
post_id | string | Unique activity / post identifier. |
author_type | string | Example: person |
author_slug | string | Example: darioamodei |
author_name | string | Example: Dario Amodei |
author_headline | string | Example: CEO and Co-Founder at Anthropic |
text | string | Full post body text. |
like_count | integer | Total reaction / like count. |
comment_count | integer | Total comment count. |
repost_count | integer | Total repost / share count. |
media_type | string | Example: text |
post_url | string | Example: https://www.linkedin.com/feed/update/urn:li:activity:7258991 |
posted_at | string | ISO-8601 publication timestamp. |
meta | object | Pagination, freshness, and billing metadata. |
page | integer | Current 1-indexed page number. |
limit | integer | Maximum records returned per page. |
has_more | boolean | Whether additional pages are available. |
next_page | integer | Next page number to request (null if at end). |
credits_charged | integer | Exact unified credits deducted for this call. |
Status Codes
- 200
- Success (
code === 0). Deducts 2 Credits per post returned (min 10 Credits on hit).