> ## Documentation Index > Fetch the complete documentation index at: https://docs.socq.ai/llms.txt > Use this file to discover all available pages before exploring further. # Instagram Location Search > Search Instagram locations by name or coordinates. # Instagram Location Search Search Instagram locations by a place name or by latitude and longitude, and get location IDs with names, addresses, cities and coordinates. Submit an asynchronous task, then read its standard results. ```json theme={null} { "query": "Times Square" } ``` Search by place name with query, or by a point on the map with latitude and longitude. Coordinate search returns the places around that point. ## Standard Result Fields Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use `fields` for MCP queries, `_result_fields` for typed tools, or `--result-fields` in the CLI. Declared fields remain present when their value is `null`. | Field | Type | Nullable | Description | | - | - | - | - | | `id` | `string` | Yes | Unique identifier for this result item. | | `platform` | `string` | No | Platform the result belongs to, such as `instagram` or `linkedin`. | | `resource` | `string` | No | SocQ resource represented by the result, such as `videos` or `comments`. | | `type` | `string` | No | Category of the result item, such as `video`, `post`, or `comment`. | | `url` | `string` | Yes | Public URL of the result item when available. | | `published_at` | `string` | Yes | Time the source item was published, in ISO 8601 format when available. | | `collected_at` | `string` | No | Time SocQ collected or processed this result, in ISO 8601 format. | | `name` | `string` | Yes | Place or business name. | | `text` | `string` | Yes | Primary text associated with the result item. | | `category` | `string` | Yes | Category assigned to the result item. | | `address` | `string` | Yes | Public street or formatted address. | | `phone` | `string` | Yes | Public contact phone number. | | `website` | `string` | Yes | Website associated with the account, company, or advertiser. | | `rating` | `number` | Yes | Rating value reported by the platform. | | `reviews_count` | `integer` | Yes | Number of reviews. | | `location` | `object` | Yes | Geographic location associated with the result. | | `location.name` | `string` | Yes | Human-readable location name. | | `location.city` | `string` | Yes | City name. | | `location.region` | `string` | Yes | Region, state, or province name. | | `location.country` | `string` | Yes | Country or territory name or code. | | `location.latitude` | `number` | Yes | Latitude in decimal degrees. | | `location.longitude` | `number` | Yes | Longitude in decimal degrees. | The following example shows the response format for a completed task. Actual data depends on your query. ## Completed Task Response ```json theme={null} { "code": 200, "data": { "task_id": "example-instagram-location-search", "status": "succeeded", "public_id": "instagram/location-search", "result_count": 1, "credits_amount": 0.5, "results": { "limit": 50, "next_cursor": null, "has_more": false, "schema_id": "place", "schema_version": "1.0", "items": [ { "id": "2295813", "platform": "instagram", "resource": "location-search", "type": "place", "url": "https://www.instagram.com/explore/locations/2295813/", "published_at": null, "collected_at": "2026-11-09T06:37:43Z", "name": "YOTEL New York", "text": null, "category": null, "address": "570 Tenth Avenue At W 42nd Street", "phone": null, "website": null, "rating": null, "reviews_count": null, "location": { "name": "YOTEL New York", "city": null, "region": null, "country": null, "latitude": 40.75920607, "longitude": -73.99558548 } } ] } } } ``` ## OpenAPI ````yaml api-manual/agent-api/agent-api.json POST /v1/instagram/location-search openapi: 3.1.0 info: title: SocQ Agent API version: v1-49b371f0f690 description: Asynchronous social data API generated from the SocQ Capability Registry. servers: - url: https://api.socq.ai security: [] paths: /v1/instagram/location-search: post: tags: - instagram summary: Instagram Location Search API description: Search Instagram locations by name or coordinates. operationId: socq_instagram_location_search requestBody: required: true content: application/json: schema: $schema: https://json-schema.org/draft/2020-12/schema type: object additionalProperties: false properties: callback_url: type: string format: uri latitude: type: number minimum: -90 maximum: 90 longitude: type: number minimum: -180 maximum: 180 query: type: string minLength: 1 description: Place name, landmark or city to search for. maxLength: 100 required: [] description: >- Search by place name with query, or by a point on the map with latitude and longitude. Coordinate search returns the places around that point. anyOf: - required: - query - required: - latitude - longitude responses: '200': description: Task accepted content: application/json: schema: $ref: '#/components/schemas/AgentSubmitResponse' '422': description: Input validation failed content: application/json: schema: $ref: '#/components/schemas/AgentValidationErrorResponse' security: - bearerAuth: [] - apiKeyAuth: [] components: schemas: AgentSubmitResponse: type: object properties: code: type: integer const: 200 data: type: object properties: task_id: type: string status: type: string created_time: type: - string - 'null' required: - task_id - status AgentValidationErrorResponse: type: object properties: code: type: integer const: 422 error: type: object properties: message: type: string type: type: string details: type: object required: - message - type required: - code - error securitySchemes: bearerAuth: type: http scheme: bearer apiKeyAuth: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.