Catalogue
Get service
One catalogue entry: input spec, typed options, and the offers behind a service. No authentication required.
GET
/
v1
/
services
/
{platform}
/
{service}
curl https://api.socialrouter.io/v1/services/googlemaps/place.search
const response = await fetch(
"https://api.socialrouter.io/v1/services/googlemaps/place.search",
);
const service = await response.json();
import requests
response = requests.get(
"https://api.socialrouter.io/v1/services/googlemaps/place.search"
)
service = response.json()
const service = await sr.getService("googlemaps/place.search");
{
"platform": "googlemaps",
"service": "place.search",
"endpoint": "/v1/googlemaps/place.search",
"input_kind": "query",
"input_field": "queries",
"accepts": [
{
"format": "Free-text search query",
"example": "best pizza in Brooklyn, NY"
}
],
"options": [],
"offers": [
{ "offer": "apify/compass", "source": "apify", "price_per_record": 0.00552, "max_inputs": 100 }
]
}
{
"error": {
"code": "unknown_service",
"message": "Unknown service \"place.info.search\" on googlemaps. Did you mean \"googlemaps/place.search\"?",
"type": "not_found"
}
}
{
"error": {
"code": "service_not_available",
"message": "linkedin/post.comments is not served by any offer yet.",
"type": "not_found"
}
}
This endpoint does not require authentication. It returns the same entry shape as
GET /v1/services, for a single service.
string
required
One of:
linkedin, instagram, x, reddit, facebook, tiktok, youtube, pinterest, bluesky, snapchat, googlemaps.string
required
A service of that platform, e.g.
subreddit.posts. Unknown names return 404 with a did-you-mean.curl https://api.socialrouter.io/v1/services/googlemaps/place.search
const response = await fetch(
"https://api.socialrouter.io/v1/services/googlemaps/place.search",
);
const service = await response.json();
import requests
response = requests.get(
"https://api.socialrouter.io/v1/services/googlemaps/place.search"
)
service = response.json()
const service = await sr.getService("googlemaps/place.search");
{
"platform": "googlemaps",
"service": "place.search",
"endpoint": "/v1/googlemaps/place.search",
"input_kind": "query",
"input_field": "queries",
"accepts": [
{
"format": "Free-text search query",
"example": "best pizza in Brooklyn, NY"
}
],
"options": [],
"offers": [
{ "offer": "apify/compass", "source": "apify", "price_per_record": 0.00552, "max_inputs": 100 }
]
}
{
"error": {
"code": "unknown_service",
"message": "Unknown service \"place.info.search\" on googlemaps. Did you mean \"googlemaps/place.search\"?",
"type": "not_found"
}
}
{
"error": {
"code": "service_not_available",
"message": "linkedin/post.comments is not served by any offer yet.",
"type": "not_found"
}
}
Previous
List sourcesThe data sources behind the offers, with coverage counts. No authentication required.
Next
⌘I
curl https://api.socialrouter.io/v1/services/googlemaps/place.search
const response = await fetch(
"https://api.socialrouter.io/v1/services/googlemaps/place.search",
);
const service = await response.json();
import requests
response = requests.get(
"https://api.socialrouter.io/v1/services/googlemaps/place.search"
)
service = response.json()
const service = await sr.getService("googlemaps/place.search");
{
"platform": "googlemaps",
"service": "place.search",
"endpoint": "/v1/googlemaps/place.search",
"input_kind": "query",
"input_field": "queries",
"accepts": [
{
"format": "Free-text search query",
"example": "best pizza in Brooklyn, NY"
}
],
"options": [],
"offers": [
{ "offer": "apify/compass", "source": "apify", "price_per_record": 0.00552, "max_inputs": 100 }
]
}
{
"error": {
"code": "unknown_service",
"message": "Unknown service \"place.info.search\" on googlemaps. Did you mean \"googlemaps/place.search\"?",
"type": "not_found"
}
}
{
"error": {
"code": "service_not_available",
"message": "linkedin/post.comments is not served by any offer yet.",
"type": "not_found"
}
}