> ## Documentation Index > Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt > Use this file to discover all available pages before exploring further. # Location Search > Look up cities and regions on Facebook Marketplace and get the coordinates you'll need to call the Marketplace Search endpoint. 💳 **1 credit** per request ## OpenAPI ````yaml GET /v1/scrape/facebook-marketplace/location-search openapi: 3.1.0 info: title: SociaVault API version: 1.0.0 description: >- # SociaVault API Documentation The SociaVault API provides comprehensive access to social media data extraction across multiple platforms. ## Features - **Multi-Platform Support**: TikTok, Instagram, YouTube, Facebook, Twitter, Reddit, Threads, and more - **Credit-Based System**: Pay-as-you-go pricing with transparent credit costs - **High Performance**: Fast, reliable data extraction - **Comprehensive Data**: Detailed user profiles, videos, posts, comments, and analytics ## Authentication All API requests require authentication using an API key in the `X-API-Key` header: ```bash X-API-Key: sk_live_your_api_key_here ``` Get your API key from the [SociaVault Dashboard](https://sociavault.com/dashboard). ## Credits Each endpoint consumes credits based on data complexity: - Simple requests (profiles): 1 credit - Complex requests (demographics): 20+ credits - Paginated requests: Credits per page Check your credit balance in the dashboard or via the API. ## Support - **Documentation**: https://docs.sociavault.com - **Email**: support@sociavault.com - **Discord**: https://discord.gg/sociavault contact: name: SociaVault Support email: support@sociavault.com url: https://sociavault.com/support license: name: Commercial url: https://sociavault.com/terms servers: - url: https://api.sociavault.com description: Production API security: - ApiKeyAuth: [] tags: - name: account description: Account management and credit balance externalDocs: description: Learn more url: https://docs.sociavault.com/account - name: tiktok description: Scrape TikTok profiles, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok - name: tiktok-shop description: Everything about TikTok Shop externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok-shop - name: instagram description: Gets Instagram profiles, posts, and reels externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/instagram - name: youtube description: Scrape YouTube channels, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/youtube - name: linkedin description: Scrape LinkedIn externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedin - name: facebook description: Get public Facebook profiles and posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebook - name: facebookAdLibrary description: Scrapes the Facebook (Meta) Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookAdLibrary - name: facebookMarketplace description: Search Facebook Marketplace and pull full listing details externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookMarketplace - name: googleAdLibrary description: >- Scrape the Google Ad Transparency Library. *This only gets the public ads. Some ads you need to log in for and sadly we can't get those. Also, since there are so many variations, the return types might not all be 100% the same. externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/googleAdLibrary - name: linkedinAdLibrary description: Search the LinkedIn Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedinAdLibrary - name: twitter description: Get Twitter profiles, tweets, followers and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/twitter - name: reddit description: Scrape Reddit posts and comments externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/reddit - name: threads description: Get Threads posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/threads - name: google description: Scrape Google search results externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/google paths: /v1/scrape/facebook-marketplace/location-search: get: tags: - facebookMarketplace summary: Location Search description: >- Look up cities and regions on Facebook Marketplace and get the coordinates you'll need to call the Marketplace Search endpoint. operationId: facebookMarketplace_Location_Search parameters: - name: query in: query description: Location search query required: true schema: type: string example: Austin responses: '200': description: >- Successful response **Key Response Fields:** - `data.locations[0].name`: Full location display name (e.g. `"London, United Kingdom"`) - `data.locations[0].city`: City name - `data.locations[0].latitude` / `longitude`: Coordinates — pass these as `lat` / `lng` to the Marketplace Search endpoint - `data.locations[0].page_id`: Facebook page ID for the location - `data.locations[0].subtitle`: Human-readable description with check-in count - `data.locations[0].postal_code`: Postal / ZIP code for the location content: application/json: example: success: true data: success: true locations: '0': name: London, United Kingdom subtitle: City multi_line_address: {} page_id: '106078429431815' latitude: 51.5141 longitude: -0.1094 city: London postal_code: EC4Y 1 '1': name: Hampstead, United Kingdom subtitle: Hampstead, UK · 103,978 people checked in here multi_line_address: {} page_id: '111970842163262' latitude: 51.562662002368 longitude: -0.17988194651705 city: London postal_code: NW3 7 '2': name: Hanwell, London, United Kingdom subtitle: Hanwell, UK · 36,446 people checked in here multi_line_address: {} page_id: '111657852196045' latitude: 51.511547559951 longitude: -0.33753365471487 city: London postal_code: W7 3 '3': name: Walthamstow, United Kingdom subtitle: Walthamstow, UK · 203,329 people checked in here multi_line_address: {} page_id: '106346746071495' latitude: 51.5836 longitude: -0.0211 city: London postal_code: E17 7 '4': name: Ealing, United Kingdom subtitle: Ealing, UK · 121,903 people checked in here multi_line_address: {} page_id: '106501136052910' latitude: 51.5 longitude: -0.316667 city: London postal_code: W13 9TF '5': name: Barking, United Kingdom subtitle: City multi_line_address: {} page_id: '114818845200946' latitude: 51.53928 longitude: 0.0813 city: Barking postal_code: IG11 8 '6': name: Hampton, London, United Kingdom subtitle: City multi_line_address: {} page_id: '104340056273555' latitude: 51.41757 longitude: -0.37365 city: Hampton postal_code: TW12 2JT '7': name: Chingford, United Kingdom subtitle: Chingford, UK · 80,067 people checked in here multi_line_address: {} page_id: '116561138354646' latitude: 51.6313 longitude: 0.003 city: London postal_code: E4 7BJ '8': name: Chelsea, London subtitle: Chelsea, UK · 330,172 people checked in here multi_line_address: {} page_id: '103119536394979' latitude: 51.4862 longitude: -0.1653 city: London postal_code: SW3 5TB '9': name: Haggerston (ward) subtitle: Haggerston, UK · 43 people checked in here multi_line_address: {} page_id: '102589439795413' latitude: 51.5318 longitude: -0.0706 city: London postal_code: E2 8NG creditsUsed: 1 '400': description: Bad Request - Invalid parameters or missing required fields content: application/json: schema: type: object properties: error: type: string example: Search query parameter is required endpoint: type: string credits_required: type: integer required: - error '401': description: Unauthorized - Invalid or missing API key content: application/json: schema: type: object properties: error: type: string example: Invalid API key docs: type: string example: https://docs.sociavault.com/authentication required: - error '402': description: Payment Required - Insufficient credits content: application/json: schema: type: object properties: error: type: string example: Insufficient credits required: type: integer example: 1 description: Credits required for this request available: type: integer example: 0 description: Credits currently available required: - error - required - available '500': description: Internal Server Error - Service configuration or processing error content: application/json: schema: type: object properties: error: type: string example: Service configuration error required: - error components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: |- API key for authentication. Format: `sk_live_xxxxxxxxxxxxx` Get your API key from the [Dashboard](https://sociavault.com/dashboard). ````