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
| Operation | What it does | A call |
|---|---|---|
Google Maps: Get a placegoogle_maps/places/get | One 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/search | One page of places for a Google Maps search, 20 at most, as the results list shows them. | 20 |
Google Maps: List reviewsgoogle_maps/reviews/list | One 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/search | The 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/check | Whether a LaCentrale vehicle listing is still online, with its dates. | 1 |
LaCentrale: Get a vehicle listinglacentrale/listings/get | One complete LaCentrale vehicle listing: description, specifications, equipment, photos, history preview, warranties and public seller details. | 4 |
LaCentrale: Search vehicle listingslacentrale/listings/search | One 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/check | Whether a leboncoin.fr listing is still online (active, paused by its seller, or gone), with its dates. | 1 |
Leboncoin: Get a listingleboncoin/listings/get | One 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/search | One 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/get | The phone number a seller shows on one leboncoin.fr listing, read with a connected Leboncoin account. | 6 |
Realtor.com: Get a listingrealtor/listings/get | One 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/search | One 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/get | One seloger.com listing, whole, as its page shows it, the agency's phone included. | 1 |
SeLoger: Search listingsseloger/listings/search | One 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/get | The 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/list | The 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/list | The 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/get | A 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/list | The 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/search | The 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.