Search LinkedIn posts - Autotouch AI

This page documents the canonical HTTP contract for this endpoint.

Provide exactly one of query or company_pages. This endpoint reads connected-account LinkedIn data; it is not the provider-hidden public-web search family. API keys require both search:run and linkedin:read.

The operation reports connected LinkedIn read with no Autotouch source credits; check credits_used and pricing_rule in the response.

The common response envelope contains items, total_found, billable_results, credits_used, pricing_rule, and metadata. Result item fields depend on this search family.

Body parameters

query · optional
string
Optional search query, 2–500 characters.
company_pages · optional
array<string>
Up to five public LinkedIn company URLs or page slugs.
limit · optional
integer
Maximum results; default 12, range 1–12.

Name	Type	Description
query	string	Optional search query, 2–500 characters.
company_pages	array<string>	Up to five public LinkedIn company URLs or page slugs.
limit	integer	Maximum results; default 12, range 1–12.

Errors

Status	Meaning
400	The search command or provider rejected the request.
401	Authentication is required.
402	Insufficient credits for this search.
403	Developer API key lacks required scope: search:run + linkedin:read.
422	A request field is missing, outside its allowed range, or fails the typed request contract.

Example

bash

curl -X POST "https://app.autotouch.ai/api/search/linkedin-posts" -H "Authorization: Bearer $AUTOTOUCH_API_KEY" -H "Content-Type: application/json" -d '{"company_pages":["acme"],"limit":12}'

Request body

json

{
  "company_pages": [
    "acme"
  ],
  "limit": 12
}

Response example

json

{
  "items": [],
  "total_found": 0,
  "billable_results": 0,
  "credits_used": 0,
  "pricing_rule": "<effective rule for this search>",
  "metadata": {}
}