Skip to content
Operations

Operations: one call, one page of records

What a lobstr.io operation is, what a call costs, how pages and your own accounts work, and where to see every call you made.

An operation does one thing on one site, and is named after it: google_maps/places/search searches places on Google Maps, x/tweets/list lists a profile's tweets. You call it with its options; the answer comes back in the same call, in seconds, with its records as JSON, the same fields every time.

You call an operation from the app's store, from your code, or from your AI agent.

Every operation

OperationWhat it doesA call
Google Maps: Get a placegoogle_maps/places/getOne place's page on Google Maps, by its id, its link or its name, with everything places/search gives and its photos.1
Google Maps: Search placesgoogle_maps/places/searchOne page of places for a Google Maps search, 20 at most, as the results list shows them.20
Google Maps: List reviewsgoogle_maps/reviews/listOne page of a Google Maps place's reviews, 10 at most, with their rating, text, author, photos and owner reply.2
Google News: Search articlesgoogle_news/articles/searchThe articles of a Google News search, up to 100, as Google ranks them, each with its publisher's URL.100
LaCentrale: Check a listing is still onlinelacentrale/listings/checkWhether a LaCentrale vehicle listing is still online, with its dates.1
LaCentrale: Get a vehicle listinglacentrale/listings/getOne complete LaCentrale vehicle listing: description, specifications, equipment, photos, history preview, warranties and public seller details.4
LaCentrale: Search vehicle listingslacentrale/listings/searchOne LaCentrale page: up to 23 vehicles with specifications and public seller phones, for 23 credits per nonempty call even when limit returns fewer records.23
Leboncoin: Check a listing is still onlineleboncoin/listings/checkWhether a leboncoin.fr listing is still online (active, paused by its seller, or gone), with its dates.1
Leboncoin: Get a listingleboncoin/listings/getOne leboncoin.fr listing, whole, by its id or URL, with a search's fields and how many people saved it.3
Leboncoin: Search listingsleboncoin/listings/searchOne page of a leboncoin.fr search, 35 listings at most, exactly as the page shows them, descriptions included.100
Leboncoin: Get a seller's phone numberleboncoin/phones/getThe phone number a seller shows on one leboncoin.fr listing, read with a connected Leboncoin account.6
Realtor.com: Get a listingrealtor/listings/getOne realtor.com listing, whole, as its page shows it read to the end: agents, history, taxes, schools, risks, estimates.1
Realtor.com: Search listingsrealtor/listings/searchOne page of a realtor.com search, 42 homes for sale or sold, as the page shows them, with the MLS's wishes on AI use.21
SeLoger: Get a listingseloger/listings/getOne seloger.com listing, whole, as its page shows it, the agency's phone included.1
SeLoger: Search listingsseloger/listings/searchOne page of a seloger.com search, 30 listings, as the page shows them, the agency's phone included.15
Websites: Get a website's contactswebsites/contacts/getThe emails, phone numbers and profiles (social networks, directories) a company's website shows, each with its page.1
X (Twitter): List a profile's followersx/followers/listThe accounts that follow a profile on X (Twitter), the most recent first, each with its name, bio, counts and verification, read with your connected X account.20
X (Twitter): List the accounts a profile followsx/following/listThe accounts a profile follows on X (Twitter), the most recently followed first, each with its name, bio, counts and verification, read with your connected X account.20
X (Twitter): Get a profilex/profiles/getA profile on X (Twitter) by its handle: its name, bio, links, follower and tweet counts, verification, affiliation and images, read with your connected X account.1
X (Twitter): List a profile's tweetsx/tweets/listThe tweets of a profile on X (Twitter), tab by tab (posts, replies, reposts, videos, photos), newest first, 20 or so a page, with their text, counts, media and author, read with your connected X account.20
X (Twitter): Search tweetsx/tweets/searchThe tweets of a search on X (Twitter), 20 a page, with their text, counts, media and author, read with your connected X account.20

What a call costs

Each operation has a fixed price per call, in credits, whatever the call brings back: 1 credit for a Google Maps place, 20 for a page of 20 places. The price is on the operation's page.

  • A failed call is free, whether the site or lobstr.io is at fault.
  • An empty page is free for most searches: the operation's page says it.
  • No credits left? The call is refused before it runs, and costs nothing.

One balance pays for operations and batches. More in Credits.

One page per call

A search or a list answers one page of records. When there is more, the answer gives the call for the next page: make it for the following records, and stop when you have enough. Each page is a call, at the operation's price.

Calls at a time

Your plan runs a number of calls at the same time: 1 on Free, 2 on Starter, 10 on Pro, 50 on Team. One more is refused at once, without charge: retry when a call has finished. See Calls and runs at a time.

With your own account

A few operations read what a site shows only behind a login, such as a Leboncoin seller's phone number, or profiles and tweets on X. They run with an account you connect once, by sending its login cookies to the API: see Accounts. Each account goes at the site's pace, so more accounts mean more calls.

Your calls and their answers

In the app, Usage → Calls lists your calls. Click one to see its request and its whole answer, records included.

Answers are kept 7 days on Free, 45 days on Starter and Pro, 90 days on Team.

An operation or a batch?

You want Use
One place, one listing, one page of results, now An operation
Data inside your code or your AI agent An operation
A list of hundreds of inputs A batch
The same search every day A batch, scheduled
A CSV, a Google Sheet or files in S3 A batch, with its export