Marketplace Locations

GET/v1/facebook/marketplace/location/search1 credit

Searches Marketplace locations by name and returns up to 10 places with address, city and coordinates.

01Query parameters

Name	Type	Description
queryrequired	string	A place name, e.g. `Austin, Texas`.

02Request

curl "https://api.scrapesocial.ai/v1/facebook/marketplace/location/search?query=Austin%2C+Texas" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/facebook/marketplace/location/search?query=Austin%2C+Texas

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "locations": [
    {
      "name": "Austin, Texas",
      "subtitle": "City",
      "multi_line_address": [],
      "page_id": "106224666074625",
      "latitude": 30.2677,
      "longitude": -97.7475,
      "city": "Austin",
      "postal_code": "78701"
    },
    {
      "name": "University of Texas-Austin",
      "subtitle": "University of Texas-Austin, TX, US · 42,095 people checked in here",
      "multi_line_address": [],
      "page_id": "111944028832853",
      "latitude": 30.284865,
      "longitude": -97.733465,
      "city": "Austin",
      "postal_code": "78712-1753"
    }
  ]
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Use a result's `latitude` and `longitude` as `lat` and `lng` on /v1/facebook/marketplace/search. A query that matches nothing returns an empty list for 0 credits.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.