> ## Documentation Index
> Fetch the complete documentation index at: https://docs.joinmassive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Geotargeting

> Search, chat, and browse from anywhere.

## Local content

Every HTTP request can be routed through one of more than 190 countries, by subdivision and city:

```shell theme={null}
curl -H "Authorization: Bearer $MASSIVE_TOKEN" \
'https://render.joinmassive.com/search'\
'?terms=musical+instruments'\
'&country=us'
```

<AccordionGroup>
  <Accordion icon="terminal" title="View subdivision-targeting example">
    ```shell theme={null}
    curl -H "Authorization: Bearer $MASSIVE_TOKEN" \
    'https://render.joinmassive.com/ai'\
    '?prompt=find+vintage+guitar+stores'\
    '&country=us'\
    '&subdivision=tn'
    ```
  </Accordion>

  <Accordion icon="terminal" title="View city-targeting example">
    ```shell theme={null}
    curl -H "Authorization: Bearer $MASSIVE_TOKEN" \
    'https://render.joinmassive.com/browser'\
    '?url=https://guitars.com/'\
    '&country=us'\
    '&city=Nashville'
    ```
  </Accordion>
</AccordionGroup>

These are the geotargeting request parameters:

| Key           | Required | Value                                                                                                                                                                                                                                                                    |
| :------------ | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `country`     | ⬜        | The [two-letter ISO code](https://www.iso.org/obp/ui/#search/code) of the country to browse from (these codes are case insensitive); a random country is used by default                                                                                                 |
| `subdivision` | ⬜        | The alphanumeric second part (proceeding the separator) of a [first-level subdivision code](https://www.iso.org/obp/ui/#search/code) in the (prerequisite) country to browse from (these codes are case insensitive); a random subdivision is used by default            |
| `city`        | ⬜        | The [commonly spelled name](https://www.geonames.org/) of the city in the (prerequisite) country to browse from (these names are temporarily case sensitive and required to include form- or URL-encoded spaces and punctuation marks); a random city is used by default |

<Warning>
  City targeting takes precedence over subdivision targeting if both are specified.
</Warning>

These are the response parameters:

| Key           | Value                                                                        |
| :------------ | :--------------------------------------------------------------------------- |
| `country`     | The ISO code of the country that was browsed from                            |
| `subdivision` | The partial ISO code of the subdivision in the country that was browsed from |
| `city`        | The common name of the city in the country that was browsed from             |